SupportWire API
API ReferenceO Auth

Grant consent

Approve the authorization and mint a single-use authorization code.

POST
/api/oauth/authorize/consent

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/oauth/authorize/consent" \  -H "Content-Type: application/json" \  -d '{    "client_id": "string",    "redirect_uri": "string",    "target_organization_id": "string"  }'
{
  "redirect_to": "string"
}
{
  "error": "insufficient_scope",
  "error_description": "The token is missing a required scope."
}
{
  "error": "insufficient_scope",
  "error_description": "The token is missing a required scope."
}

Authorize request

Validate an authorization request and return consent metadata (app details, requested scopes, and the organizations the signed-in user may connect). Requires an authenticated user session.

Exchange code for token

Back-channel call from your server. Exchange an authorization code for an access token. Authenticate with `client_id`/`client_secret` in the body or via HTTP Basic auth.