List a brand's categories
Flat, with parentId — the tree is derived, never stored, so a breadcrumb is built by walking parents (ADR-0027).
Authorization
apiKey Your API key. X-Api-Key: <key> is accepted as an alternative.
A key belongs to an organization, not a user, so it outlives whoever created it. It carries two independent things, and both are checked: an org role (a member key cannot approve a publish or activate a mapping) and a set of scopes — catalog:read, catalog:write, enrichment:write, publishing:read, publishing:write, org:read, org:write. Holding a scope does not grant a role, and holding a role does not grant a scope.
GET /v1/me returns both for the key you are holding.
In: header
Path Parameters
The brand to read.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/brands/string/categories"{ "data": [ null ]}Download results as NDJSON GET
One result per line, oldest first, each carrying your `ref`. The canonical format: stream it rather than holding a run in memory. `verdict.outcome` is the default — `review` rows are a find that a human should look at (a variant, a low score), `reject` rows are not the product.
Create a category POST
Optionally under a parent. Names are unique among siblings, not across the brand — two parents may each have a `Boots`.