This endpoint performs a partial update. Only the fields you send are modified. key and type cannot be changed.
Body fields
| Field | Type | Description |
|---|---|---|
label | string | New display name |
options | array | Replaces the full option list with { label, key? } objects. DROPDOWN attributes only |
prompt | string | Instruction for the AI CRM Manager. A blank value clears it |
should_prompt_override | boolean | Whether the AI may overwrite a value that is already set |
is_visible | boolean | Show or hide the attribute in the Allo apps |
Renaming options
Option keys stay stable. To rename an option, send its current key with the new label. An option sent without a matching key is treated as new and gets a key derived from its label. Options missing from the list are removed.
Attributes synced from a CRM
An attribute whose source is not allo is managed by your CRM integration. Only prompt, should_prompt_override and is_visible can be changed. Sending label or options returns 409 ATTRIBUTE_MANAGED_BY_INTEGRATION.
Response
Returns 200 with the updated attribute, in the same shape as List company attributes.
Errors
| Status | Code | When |
|---|---|---|
400 | ATTRIBUTE_LABEL_INVALID | label is blank, longer than 255 characters, or has no letter or digit |
400 | ATTRIBUTE_OPTION_INVALID | options is empty, or an option label is blank, longer than 255 characters or duplicated |
400 | ATTRIBUTE_OPTIONS_NOT_SUPPORTED | options sent for an attribute that is not DROPDOWN |
403 | API_KEY_INSUFFICIENT_SCOPE | The key does not hold CRM_WRITE |
404 | TEAM_NOT_FOUND | The workspace is not on the new contact model |
404 | ATTRIBUTE_NOT_FOUND | No attribute with this key |
409 | ATTRIBUTE_MANAGED_BY_INTEGRATION | label or options sent for an attribute managed by a CRM integration |
409 | ATTRIBUTE_CONCURRENT_MODIFICATION | Attributes were modified at the same time. Retry the request |