List attribute definitions (schema discovery)
API Reference
List attribute definitions (schema discovery)
The schema of an entity type: every attribute key, its data type, whether it is writable (formulas/inverse references are not), and the parsed acceptable_values for selects. Call this FIRST and cache it — entity attributes maps are sparse, so this is the canonical “what fields exist” answer. Optionally scope to a channel.
GET
List attribute definitions (schema discovery)
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.
Query Parameters
The entity type to describe.
Available options:
product, image, vendor, category, source Restrict to one channel's attributes.
Response
Attribute definitions (not paginated).