v1

latestOpenAPI 3.1.02026-07-222392081.7 MB
OAuth2

Register OAuth client

Register a dynamic OAuth client per RFC 7591.

post/oauth/register

Request body

redirect_urisstring[] required

Array of redirect URIs for the client. HTTPS, localhost, and supported native app callback URIs are accepted.

client_namestring

Human-readable name of the client.

client_uristring uri

URL of the client's home page.

logo_uristring uri

URL of the client's logo.

scopestring

Space-separated list of requested scopes.

grant_typesstring[]

Grant types the client will use.

response_typesstring[]

Response types the client will use.

token_endpoint_auth_method'none' | 'client_secret_post'

Authentication method for token endpoint. All clients are treated as public (no secret issued).

software_idstring

Unique identifier for the client software.

software_versionstring

Version of the client software.

contactsstring[]

Contact emails for the client developers.

tos_uristring uri

URL to the client's terms of service.

policy_uristring uri

URL to the client's privacy policy.

Example request

{
  "redirect_uris": [
    "http://localhost:3000/callback"
  ],
  "client_name": "Claude Desktop",
  "scope": "read write",
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "response_types": [
    "code"
  ]
}

Response

client_idstring required

Unique client identifier.

client_id_issued_atnumber required

Unix timestamp when client_id was issued.

redirect_urisstring[] required

Registered redirect URIs.

client_namestring

Human-readable name of the client.

client_uristring

URL of the client's home page.

logo_uristring

URL of the client's logo.

scopestring

Space-separated list of granted scopes.

grant_typesstring[] required

Grant types the client can use.

response_typesstring[] required

Response types the client can use.

token_endpoint_auth_method'none' | 'client_secret_post' required

Authentication method for token endpoint.

Example response

{
  "client_id": "dyn_abc123xyz789"
}