Skip to main content
PATCH
/
field-configurations
/
{id}
Update Field Configuration
curl --request PATCH \
  --url https://api.attention.tech/v2/field-configurations/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Renamed Discovery Questions",
  "teamsUUID": [
    "fe515723-fe2e-4959-a5fa-c4d3937fe7e4"
  ]
}
'
{
  "data": {
    "uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
    "name": "Enterprise Discovery Questions",
    "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
    "teamsUUID": [
      "fe515723-fe2e-4959-a5fa-c4d3937fe7e4"
    ],
    "allTeams": false,
    "isDefaultTemplate": false
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.attention.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Path Parameters

​
id
string
required

UUID of the field configuration.

Body

Fields to update on the configuration.

Request payload for updating a field configuration. Uses PATCH semantics - only fields present in the body are updated; omitted fields are left unchanged.

​
name
string

New human-readable name. When present, trimmed; 1-128 characters.

Example:

"Renamed Discovery Questions"

​
teamsUUID
string[]

Replacement list of team UUIDs this configuration is assigned to. When omitted, existing assignments are preserved.

Example:
["fe515723-fe2e-4959-a5fa-c4d3937fe7e4"]
​
allTeams
boolean | null

When present, sets whether the configuration applies to every team in the organization.

Example:

false

​
criteria
object

Criteria expression that controls when this field configuration applies. Conditions are combined using the specified boolean operator.

Example:
{
  "conditions": [
    {
      "field": "account.industry",
      "value": "technology"
    }
  ],
  "operator": "AND"
}

Response

Field configuration successfully updated.

Envelope containing a single field configuration.

​
data
object

A Field Configuration (internally IntelligenceItemCollection) groups a set of intelligence items that are surfaced together for the teams it is assigned to. Field Configurations are scoped to a single organization.

Example:
{
  "uuid": "b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11",
  "name": "Enterprise Discovery Questions",
  "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
  "teamsUUID": ["fe515723-fe2e-4959-a5fa-c4d3937fe7e4"],
  "allTeams": false,
  "isDefaultTemplate": false,
  "criteria": {
    "conditions": [
      {
        "field": "account.industry",
        "value": "technology"
      }
    ],
    "operator": "AND"
  },
  "createdAt": "2026-03-01T12:00:00Z"
}