Skip to main content
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?"
}
'
{
  "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"
  }
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
id
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.

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.

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"
}