Buun Group Developers
Pages

Errors

How Buun Identity says no. The OAuth endpoints answer in the protocol's own shape; everything else in one envelope of its own.

Markdown

OAuth endpoints

/oauth/token and /oauth/revoke answer 400 or 401 with { "error": "...", "error_description": "..." }.

errorMeans
invalid_requestA field is missing or malformed
invalid_clientThe client is unknown, disabled, or did not prove itself
invalid_grantThe code, refresh token or subject token is wrong, spent, expired, or not this client's. One message for every cause
unauthorized_clientThis client may not use this grant
unsupported_grant_typeThe grant type is not one Buun Identity supports
invalid_scopeA scope is unknown or not allowed for this client
invalid_targetThe resource is not one this client may ask for, or not one a token can be traded for

/oauth/authorize sends the same names back to the client's redirect_uri, with state, except when the client or its redirect address cannot be trusted: then it shows a page and sends nothing.

/oauth/userinfo and /oauth/plans answer 401 with WWW-Authenticate: Bearer error="invalid_token" for a token that does not pass.

Everything else

json
{ "error": true, "errorCode": "validation.failed", "message": "The request is not valid", "issues": { "name": "name.short" }, "requestId": "..." }
errorCodeMeans
validation.failedThe body or query is not valid. issues names each field by a code
not_foundNo such thing
auth.missingNot signed in, or the caller did not prove itself
auth.code_invalidThe sign-in code is wrong or has expired
account.suspendedThe account is suspended
rate_limitedToo many requests. Wait and try again
oauth.client_invalidThe client or its redirect address cannot be trusted
oauth.unavailableSigning is not set up on this server

A product's own answers

A product's MCP server answers 401 with WWW-Authenticate: Bearer error="invalid_token" for a token that does not pass. The gateway reads a 401 as "trade again" and tries once more; anything else it shows the agent as the product failing.