Buun Group Developers
Pages

Endpoints

Every address of Buun Identity a product, an agent or the gateway calls. Paths are on the issuer of each environment, such as https://id.buungroup.com.

Markdown

Discovery

Method and pathAnswers
GET /.well-known/openid-configurationOpenID Connect provider metadata
GET /.well-known/oauth-authorization-serverThe same, for OAuth 2.1 and MCP clients (RFC 8414)
GET /.well-known/jwks.jsonThe public keys that verify every token

The metadata names buun_plans_endpoint as well as the standard endpoints, and says client_id_metadata_document_supported and resource_indicators_supported are true.

OAuth and OpenID Connect

Method and pathWho calls itWhat it does
GET /oauth/authorizeA browser, sent by a clientStarts a sign-in. Answers a redirect to the client with a code, or to the portal
POST /oauth/tokenA clientTrades a code, a refresh token, or for the gateway an access token, for tokens
POST /oauth/revokeA clientEnds a refresh token and its family. Always 200 for a known client
GET /oauth/userinfoA client with an access token holding openidsub, and email, email_verified, name and orgs as the scopes allow
GET /oauth/plansA product with an access tokenThe person's active plans, as far as that client may know

/oauth/token, /oauth/revoke, /oauth/userinfo, /oauth/plans and the discovery addresses answer any origin, so a page or a tool may call them.

Grant types

grant_typeFor
authorization_codeEvery client, with PKCE S256
refresh_tokenA client that asked for offline_access
urn:ietf:params:oauth:grant-type:token-exchangeThe gateway's exchange client only. See Token exchange

The gateway

Method and pathWhat it does
POST /mcpThe MCP endpoint, stateless over HTTP: initialize, ping, tools/list, tools/call
GET /.well-known/oauth-protected-resourceThe gateway's resource metadata (RFC 9728): its address and Buun Identity as the authorization server
GET /healthSays the Worker is up

Staff only

The issuer's /admin and the gateway's /admin are called by the staff console alone, with its own token and the acting member of staff named on every call. The issuer's admin API is described as OpenAPI 3.1 at /admin/openapi.json. A product never calls either.