CLI
Scopes
What bounds an agent, and how to check at runtime.
Scopes are the real boundary on anything running unattended. A client
without products:write cannot touch the catalog, however it is prompted.
An agent can discover its own capabilities at start-up rather than learning them from a 403:
pxb whoami --json | jq -r '.content.token.scopes[]'
Asking for something outside them fails clearly:
403 GET products
Access token is missing required scope(s): products:read
Grant narrowly — a browser sign-in starts from nothing, per company, and an API client from the scopes you tick — and give each agent its own, so you can revoke one without disturbing the rest. Every endpoint page in the API reference lists the scope it requires.
In your terminal: pxb help scopes