v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-01970424.3 KB
Oauth

OAuth authorize endpoint

This endpoint is used to initiate the OAuth authorization flow. there are two purposes for this endpoint: 1. Authenticate a user with an OAuth provider. 2. Link an existing user with an OAuth provider.

get/auth/oauth/authorize/{provider_id}

Path parameters

provider_idstring required

Query parameters

type'authenticate' | 'link'
tokenstring
provider_scopestring
error_redirect_uristring
after_callback_redirect_urlstring
stack_response_mode'json' | 'redirect'

Response mode for the OAuth authorize endpoint. Defaults to 'redirect' if not provided.

Response mode for the OAuth authorize endpoint. Defaults to 'redirect' if not provided.

hexclave_response_mode'json' | 'redirect'

Response mode for the OAuth authorize endpoint. Defaults to 'redirect' if not provided.

Response mode for the OAuth authorize endpoint. Defaults to 'redirect' if not provided.

bot_challenge_tokenstring
bot_challenge_phase'invisible' | 'visible'
bot_challenge_unavailable'true'
client_idstring required
client_secretstring required
redirect_uristring required
scopestring required
statestring required
grant_type'authorization_code' required
code_challengestring required
code_challenge_method'S256' required
response_typestring required

Response

Successful response

locationstring required