Skip to main content
POST
/
oauth
/
authorize
/
approve
cURL
curl --request POST \
  --url https://api.sandbox.humanity.org/v2/oauth/authorize/approve \
  --header 'Content-Type: application/json' \
  --data '
{
  "authorization_id": "<string>",
  "scopes": [
    "<string>"
  ]
}
'
{
  "authorization_id": "<string>",
  "status": "<unknown>",
  "code": "<string>",
  "code_expires_at": "<string>",
  "scopes": [
    "<string>"
  ],
  "granted_scopes": [
    "<string>"
  ],
  "app_scoped_user_id": "<string>",
  "organization_id": "<string>",
  "redirect_uri": "<string>",
  "client_id": "<string>",
  "state": "<string>"
}
Programmatically approve a pending authorization when operating Humanity’s consent experience server-side (for example, bespoke trust & safety workflows). Supply the authorization_id plus an optional subset of scopes to grant. The response returns an authorization code and all metadata necessary for /oauth/token. Most consumer flows should rely on the hosted consent screen; this API is intended for regulated partners that need to stitch Humanity into an existing adjudication queue.

Body

application/json
​
authorization_id
string
required
​
scopes
string[]

Response

200 - application/json
​
authorization_id
string
required
​
status
any
required
​
code
string
required
​
code_expires_at
string
required
​
scopes
string[]
required
​
granted_scopes
string[]
required
​
app_scoped_user_id
string
required
​
organization_id
string
required
​
redirect_uri
string
required
​
client_id
string
required
​
state
string