Scopes and ownership
Keys identify a workspace and environment. catalog:read reads products, history and identifier batches; compare:read compares products; intelligence:read reads commercial intelligence and coverage; merchant:write imports your catalog; watchlists:write manages watches; sources:write imports market evidence. Subscription entitlements are also required. Watch ownership comes from the verified workspace, never a client-supplied header. Rotating a key preserves workspace watches.
Bearer
httpillustrative
Example trust: illustrativeShows the shape or idea; do not use it unchanged in production.
Authorization: Bearer <server-side-api-key>