API ReferenceApplications
POST
/oauth2/v1/authorize

Request Body

application/json

response_type?string

response_type, scope and state are required for OIDC but marked optional so a PAR client may omit them from the outer authorize request and carry them via request_uri (RFC 9126 §4). The resolved values are enforced in OIDCService.OIDCAuthZEndpointStart (after applyPARToOIDCAuthZRequest): response_type and state must be present, scope must contain "openid". The PAR push (handleOIDCPAR) requires the same fields up front for fail-fast.

scope?string
Lengthlength <= 10000
client_id?string
Lengthlength <= 200
state?string
Lengthlength <= 100000
redirect_uri?string
code_challenge_method?string

PKCE

code_challenge?string
Lengthlength <= 5000
dynamic_val?string
Lengthlength <= 5000
nonce?string
Lengthlength <= 5000
ssoAppId?string
Lengthlength <= 100
loginHint?string
Lengthlength <= 1000
prompt?string
Lengthlength <= 254
flow?string
Lengthlength <= 254
flow_token?string
Lengthlength <= 254
tenant?string
Lengthlength <= 100
style?string
Lengthlength <= 254
dpop_jkt?string
Lengthlength <= 100
request_uri?string
Lengthlength <= 200
project_id?string
bg?string
Lengthlength <= 2048
theme?string
Lengthlength <= 254

OIDC POST authorization endpoint start

curl -X POST "https://api.descope.com/oauth2/v1/authorize" \  -H "Content-Type: application/json" \  -d '{}'
{}
export interface Response {}
Was this helpful?