Skip to content

Open user consent for a resource-bound public client

← HTTP API reference
View source specification ↗
GET /oauth/authorize

Browser entry for registered DCR or CIMD clients. Redirects to the sign-in and consent UI. The client must start its registered callback listener first, generate random state and an S256 challenge, and wait for the user. Validate callback state and iss before exchanging the code. A CIMD client_id is an HTTPS, non-loopback URL of a metadata document that the server fetches (size-limited). The document must repeat the URL as client_id, name the client, list HTTPS redirect_uris that pass the server's redirect rules, and declare either public authentication (none) or private_key_jwt with an RS256 or ES256 signing algorithm and an HTTPS jwks_uri. The redirect_uri you send must be one of the listed redirect_uris. Any other metadata is rejected with invalid_client. There is no per-deployment allowlist of CIMD client URLs.

Required scope

Not required

Query parameters

client_idstringRequired

The client_id of the requested resource.

redirect_uristringRequired

The redirect_uri of the requested resource.

format: "uri"

response_typestringRequired

The response_type of the requested resource.

Allowed values: code.

scopestringRequired

The scope of the requested resource.

statestringRequired

The state of the requested resource.

resourcestring

Canonical issuer for REST or issuer/mcp for MCP. Omission defaults to REST.

format: "uri"

code_challengestringRequired

The code_challenge of the requested resource.

code_challenge_methodstringRequired

The code_challenge_method of the requested resource.

Allowed values: S256.

Returns

302

Navigate to sign-in and pending consent.

No response body.

Response headers

Locationstring

format: "uri"

Errors

400

Invalid or unsupported OAuth request.

Check the request fields and any validation details, then correct the payload.