Skip to main content
PATCH
/
labels
/
{id}
Update Label
curl --request PATCH \
  --url https://api.attention.tech/v2/labels/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Buying Signal (v2)",
  "description": "Updated description of the buying signal label.",
  "aiFlow": false
}
'
{
  "data": {
    "uuid": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
    "name": "Buying Signal",
    "description": "Conversations where the prospect expresses a buying signal.",
    "aiFlow": true,
    "allTeams": false,
    "isDefaultTemplate": false,
    "options": [],
    "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
    "createdAt": "2026-04-16T18:00:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
id
string
required

UUID of the label to update.

Body

Fields to update. Omit a field to leave it unchanged.

Payload for partially updating a label. Only fields present in the body are applied (pointer-nil merge semantics). At least one mutable field must be provided.

​
name
string

New label name. Trimmed before validation. Must be unique within the organization. Renaming cascades to scorecard criteria and intelligence-item-collection criteria that reference the old name.

Required string length: 1 - 128
Example:

"Buying Signal (v2)"

​
description
string | null

New description. Pass an empty string to clear. 0 to 2000 characters. Omit to leave unchanged.

Maximum string length: 2000
Example:

"Updated description of the buying signal label."

​
aiFlow
boolean | null

New AI-flow participation value. Omit to leave unchanged.

Example:

false

​
allTeams
boolean | null

New allTeams value. Omit to leave unchanged.

Example:

true

​
options
object[]

New option set. When provided, the full list replaces the existing options. Omit to leave unchanged; send an empty array to clear.

Response

Label successfully updated

Single-resource response envelope for label endpoints.

​
data
object

A label (label category) used to classify conversations and drive AI flows, scorecard criteria, and intelligence-item-collection criteria. Labels are scoped to a single organization.

Example:
{
  "uuid": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
  "name": "Buying Signal",
  "description": "Conversations where the prospect expresses a buying signal.",
  "aiFlow": true,
  "allTeams": false,
  "isDefaultTemplate": false,
  "options": [
    {
      "value": "high-intent",
      "description": "Prospect has explicit buying signals"
    }
  ],
  "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
  "createdAt": "2026-04-16T18:00:00Z"
}