Skip to main content
PATCH
Update an attribute definition

Authorizations

Authorization
string
header
required

Workspace-scoped API key (mk_live_...). Each operation lists the scope it requires in x-required-scopes. See the Authentication guide for the full scope table and key management.

Path Parameters

key
string
required

The attribute key.

Body

application/json

Update body — the attribute is identified by the path key + entity_type. Only provided fields change; array fields replace wholesale. Accepts the same config fields as create (all optional except entity_type).

entity_type
string
required
name
string
data_type
enum<string>
Available options:
single_line_text_field,
multi_line_text_field,
rich_text_field,
number,
boolean,
date,
url,
json,
single_select_list,
multi_select_list,
image,
video,
formula,
status,
progress,
rank
ai_generated
boolean
custom_instructions
string
acceptable_values
string
default_value
string
is_primary
boolean
selected_tools
enum<string>[]
Available options:
includeDataSources,
includeImages,
includeWebSearch,
includeProductAttributes
source_attribute_keys
string[]
required_dependencies
string[]
image_model
enum<string>
Available options:
gpt-image-1,
nano-banana
image_source_attribute_key
string[]
aspect_ratio
enum<string>
Available options:
Square,
Landscape,
Portrait
video_model
enum<string>
Available options:
veo3.1
video_source_attribute_key
string[]
vision_image_source_attribute_key
string[]
inheritance_mode
enum<string>
Available options:
off,
inherit_from_parent,
rollup_from_children
rollup_aggregation
enum<string>
Available options:
unique,
all

Response

The updated attribute definition (full config).

data
object

The full attribute-definition config returned by create/update — a superset of the discovery projection (raw acceptable_values string, generation tool, constraints).

Example: