List a product's references, with positions
The key-scoped reference view: { <attribute-key>: { total, has_more, items: [{id, type, label, position}] } }. Forward list references return the same complete membership that embeds in attributes, plus explicit position. INVERSE references — which never embed in attributes because they are unbounded — are readable ONLY here: pass ?attribute=<key> and page with limit/offset (or traverse from the other side with filter[<forward-key>]=<id>).
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.
Path Parameters
The resource UUID.
Query Parameters
A reference attribute key. Required to read an inverse reference; omit for all forward reference keys.
Page size, 1–200 (default 50).
1 <= x <= 200Zero-based offset, echoed back in pagination.offset.
x >= 0Response
References grouped by attribute key.