Hanzo
OpenapiIam

Returns the OpenID Connect discovery document — the one URL you point a… — GET /v1/iam/.well-known/oauth-authorization-server

Returns the OpenID Connect discovery document — the one URL you point a standards-compliant client at so it can find every other endpoint on its own,…

GET /v1/iam/.well-known/oauth-authorization-server

Addresshttps://api.hanzo.ai/v1/iam/.well-known/oauth-authorization-server
MethodGET
Operationget_iam_.well-known_oauth-authorization-server
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the OpenID Connect discovery document — the one URL you point a standards-compliant client at so it can find every other endpoint on its own, instead of you configuring them by hand.

It advertises only what is actually implemented, so a client that reads it cannot ask for a flow that will fail: the authorization-code flow, PKCE with S256, the supported grants, and the signing algorithms whose public keys the JWKS really publishes.

The issuer is derived from the host you asked on and is the same value the tokens carry, so a client that pins the issuer never sees it change.

Request

GET /v1/iam/.well-known/oauth-authorization-server takes no parameters and no body — the credential is the whole request.

Response

The document declares no response body for this operation. It answers 200 on success and the platform error shape on failure — see Errors.

Examples

hanzo iam .well-known oauth-authorization-server

IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page