OAuth · Authorize

GET /oauth/authorize

cURL

cURL

curl --request GET \
  --url https://api.sandbox.humanity.org/v2/oauth/authorize

SDK equivalent

const { url, codeVerifier } = sdk.buildAuthUrl({
  scopes: ['is_human', 'humanity_user'],
  state: crypto.randomUUID(),
});

Kick off the OAuth 2.1 + PKCE handshake. Build URLs with HumanitySDK.buildAuthUrl or construct them manually with:

• client_id, redirect_uri, response_type=code
• scope – space-delimited preset keys (e.g. is_human is_21_plus)
• code_challenge + code_challenge_method=S256
• Optional context: state, prompt, nonce, authorization_id, login_hint

Use /oauth/authorize/context to hydrate an authorization prompt (name, avatar, requested presets) and /oauth/authorize/result to resolve the final decision if you are embedding the consent UI.

Query Parameters

client_id · string · required

redirect_uri · string · required

response_type · any · required

scope · string · required

state · string

code_challenge · string · required

code_challenge_method · any · required

authorization_id · string

login_hint · string

locale · string

nonce · string

Response

200 - application/json