Update Field Configuration Item

curl --request PATCH \
  --url https://api.attention.tech/v2/field-configurations/{id}/items/{itemId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Budget Range (revised)",
  "contents": "What budget range has the customer confirmed?"
}
'

import requests

url = "https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}"

payload = {
    "title": "Budget Range (revised)",
    "contents": "What budget range has the customer confirmed?"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Budget Range (revised)',
    contents: 'What budget range has the customer confirmed?'
  })
};

fetch('https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Budget Range (revised)',
    'contents' => 'What budget range has the customer confirmed?'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}"

	payload := strings.NewReader("{\n  \"title\": \"Budget Range (revised)\",\n  \"contents\": \"What budget range has the customer confirmed?\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Budget Range (revised)\",\n  \"contents\": \"What budget range has the customer confirmed?\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Budget Range (revised)\",\n  \"contents\": \"What budget range has the customer confirmed?\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01",
    "fieldConfigurationUUID": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
    "title": "Budget Range",
    "category": "CRM",
    "contents": "What is the customer's stated budget range?",
    "promptType": "freeform",
    "contentType": "text"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

PATCH

field-configurations

{id}

items

{itemId}

Update Field Configuration Item

curl --request PATCH \
  --url https://api.attention.tech/v2/field-configurations/{id}/items/{itemId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Budget Range (revised)",
  "contents": "What budget range has the customer confirmed?"
}
'

import requests

url = "https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}"

payload = {
    "title": "Budget Range (revised)",
    "contents": "What budget range has the customer confirmed?"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Budget Range (revised)',
    contents: 'What budget range has the customer confirmed?'
  })
};

fetch('https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Budget Range (revised)',
    'contents' => 'What budget range has the customer confirmed?'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}"

	payload := strings.NewReader("{\n  \"title\": \"Budget Range (revised)\",\n  \"contents\": \"What budget range has the customer confirmed?\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Budget Range (revised)\",\n  \"contents\": \"What budget range has the customer confirmed?\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Budget Range (revised)\",\n  \"contents\": \"What budget range has the customer confirmed?\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01",
    "fieldConfigurationUUID": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
    "title": "Budget Range",
    "category": "CRM",
    "contents": "What is the customer's stated budget range?",
    "promptType": "freeform",
    "contentType": "text"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

{
  "id": "not_found_error",
  "status": "404",
  "code": "404",
  "title": "Not Found Error",
  "detail": "The requested resource was not found",
  "source": {
    "pointer": "/data/attributes/id"
  }
}

Authorizations

Authorization

string

header

required

Path Parameters

string

required

UUID of the field configuration.

itemId

string

required

UUID of the field-configuration item.

Body

Fields to update on the item.

Request payload for updating an existing field-configuration item. Uses PATCH semantics - only fields present in the body are updated.

title

string

New title. Trimmed; 1-128 characters.

Example:

"Budget Range (revised)"

contents

string

New prompt text.

Example:

"What budget range has the customer confirmed?"

description

string

Optional new description. 0-2000 characters.

Example:

"Revised for the 2026 playbook."

promptType

string

New prompt family.

Example:

"freeform"

contentType

string

New content type hint.

Example:

"text"

responseType

string

New response type hint.

Example:

"number"

options

string[]

New allowed response values.

Example:

["small", "medium", "large"]

dependsOn

string[]

New dependency list.

maxValues

integer | null

New maximum number of values for multi-select items.

Example:

1

allowLongResponse

boolean | null

Whether the analyzer may produce a longer free-text response.

Example:

false

extractQuotes

boolean | null

Whether the analyzer should attach supporting quotes.

Example:

true

analysisLevel

enum<string>

New analysis level.

Available options:

conversation,

deal,

lead,

contact,

account

Example:

"conversation"

metadata

object

Numeric scoring metadata for a field-configuration item. Required when the item represents a numeric score - min_score must be less than or equal to max_score.

Show child attributes

Example:

{
  "min_score": 0,
  "max_score": 10,
  "min_criteria": "No fit",
  "max_criteria": "Perfect fit"
}

Response

Item successfully updated.

Envelope containing a single field-configuration item.

data

object

A single field within a Field Configuration (internally IntelligenceItem). Items describe a prompt that Attention evaluates against a conversation and produces a value for. A field-configuration item is cloned as one IntelligenceItemAssignment per team the parent configuration is assigned to - see IntelligenceItemAssignment.

Show child attributes

Example:

{
  "uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01",
  "fieldConfigurationUUID": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
  "title": "Budget Range",
  "category": "CRM",
  "contents": "What is the customer's stated budget range?",
  "promptType": "freeform",
  "contentType": "text",
  "analysisLevel": "conversation",
  "createdAt": "2026-03-01T12:00:00Z",
  "lastModifiedAt": "2026-03-02T08:30:00Z"
}

Authentication

General Insights

Conversation

Team

API Key

User

Email

Tool

Scorecard

Organization

Calendar

Chat

Scim

Library

Super Agent

CRM

Integration

Knowledge Base

Label

Field Configuration

RecorderMetrics

Proactive

Update Field Configuration Item

Authorizations

Path Parameters

Body

Response