Skip to main content
PATCH
Update custom company attribute
Required scope: CRM_WRITE
This endpoint performs a partial update. Only the fields you send are modified. key and type cannot be changed.

Body fields

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

Authorizations

Authorization
string
header
required

Path Parameters

key
string
required

Attribute key, as returned by the list endpoint

Example:

"industry_segment"

Body

application/json

All fields are optional

label
string

New display name

options
object[]

Replaces the full option list. DROPDOWN attributes only. Send an option's current key to keep it when renaming its label.

prompt
string | null

Instruction the AI CRM Manager follows to fill this attribute from calls. A blank value clears it.

Example:

"Pick the segment that matches the company size mentioned on the call."

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

Response

The updated attribute

data
object

A custom attribute on companies