Update canonical Attribute metadata
Type is immutable and key changes use the dedicated rename operation. Relation kind is also immutable. Omitted fields remain unchanged.
Usage notes
- Omitted fields remain unchanged.
typeand the Relation kind are immutable. - Send
expected_updated_atfrom your latest read to prevent overwriting a newer edit. A stale value returns409with codestale_writeandcurrent_updated_at. - A source-managed Attribute rejects source-owned changes unless you set
detach: truein the same request. - Sending an empty
image_configclears canonical image requirements. Sendingnumber_config: nullclears number presentation metadata.
key does not rename the Attribute. Use the dedicated rename endpoint.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Canonical Attribute key.
Body
Retained for request compatibility but does not rename the Attribute. Use the rename operation.
Only valid for format Attributes. Omit to preserve the current output type; null resets it to text.
text, number, boolean, json, richtext, file, image Only valid for number or Formula-number Attributes. Send null to clear; omitted fields remain unchanged.
Relation configuration may change, but relation kind is immutable.
Omitted fields remain unchanged.
Omitted fields remain unchanged. Send an empty object to clear canonical requirements.
Detach a source-managed Attribute before editing source-owned content.
Optional compare-and-set revision. Refetch after a stale_write response.
Response
Updated Attribute
text, number, url, email, date, boolean, richtext, format, enum, tags, image, images, file, files, json, relation The stored result type produced by a format Attribute. Format formulas execute only in Extraction; Catalog stores the resulting value.
text, number, boolean, json, richtext, file, image Whether table editors may append missing enum or tag choices.
Presentation metadata for number and Formula-number Attributes. Stored and API values remain numeric.
Canonical requirements shared by every usage of an image Attribute.
Derived from archive state. Archive and restore remain Dashboard-only.
active, archived 
