Create an attribute definition
Create an attribute, including full AI-generation config (snake_case body). For an AI-generated attribute set ai_generated: true + custom_instructions (reference other attributes with {{key}}), and pick selected_tools: includeWebSearch (live web research), includeDataSources (scraped sites/CSVs), includeImages (vision), includeProductAttributes. Image/video generation models are supported. inheritance_mode shares a value across a variant family (products only).
Authorizations
Workspace-scoped API key. Available scopes:
read:products: List and read products, including variants, references, and completeness.write:products: Create, update, and upsert products and their attribute values.delete:products: Delete products.read:images: List and read images.write:images: Create, update, and upsert images and their attribute values.delete:images: Delete images.read:vendors: List and read vendors.write:vendors: Create, update, and upsert vendors and their attribute values.delete:vendors: Delete vendors.read:categories: List and read categories.write:categories: Create, update, and upsert categories and their attribute values.delete:categories: Delete categories.read:sources: List and read data sources, including scraped content.write:sources: Create data sources (triggers processing) and update their attribute values.delete:sources: Delete data sources.read:attributes: List and read attribute definitions.write:attributes: Create and update attribute definitions.read:views: List and read saved grid views (MCP surface).write:views: Create and update grid views (MCP surface).read:channels: Read the enabled channel catalog.read:events: Read the workspace change feed and per-entity events.read:jobs: List and poll asynchronous job status.
Body
Create body (snake_case, like every write body). single_select_list/multi_select_list require acceptable_values.
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 Generation prompt; reference other attributes with {{key}}.
Comma-separated allowed values for select attributes.
AI text-generation tools. includeWebSearch = live web research; includeDataSources = scraped sites/CSVs; includeImages = vision.
includeDataSources, includeImages, includeWebSearch, includeProductAttributes gpt-image-1, nano-banana Square, Landscape, Portrait veo3.1 Parent/child variant inheritance (products only; ignored for image/video attributes). inherit_from_parent = variants display the parent's value; rollup_from_children = the parent displays its variants' combined values; off removes inheritance. Virtualized at read time.
off, inherit_from_parent, rollup_from_children Only with rollup_from_children. unique = distinct values joined; all = one entry per variant. Default unique.
unique, all Response
The created attribute definition (full config).
The full attribute-definition config returned by create/update — a superset of the discovery projection (raw acceptable_values string, generation tool, constraints).