AGENT_ACCOUNT_SCOPE_REQUIRED
403authThe internal-agent token carries no account scope.
Cause
An internal-agent token reached an account-scoped endpoint without an account claim. The endpoint fails closed.
How to fix it
Mint the agent token with the account scope it needs, then retry.
Example response
403 AGENT_ACCOUNT_SCOPE_REQUIRED
JSON
{
"error_code": "AGENT_ACCOUNT_SCOPE_REQUIRED",
"error_type": "auth",
"error_message": "The internal-agent token carries no account scope.",
"hint": "Mint the agent token with the account scope it needs, then retry.",
"docs_url": "https://docs.billerapi.com/errors/AGENT_ACCOUNT_SCOPE_REQUIRED",
"request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}Related
- Error handling — the error envelope shape and how to parse it
- Error code reference — every stable error code
Canonical docs URL: https://docs.billerapi.com/errors/AGENT_ACCOUNT_SCOPE_REQUIRED
Was this page helpful?