Redeem a one-time OAuth callback exchange code

POST 
/api/v1/auth/oauth/exchange

Exchange a one-time OAuth callback code for a JWT or 2FA challenge.

The callback endpoint issues a short-lived exchange code and sets a verifier cookie on the frontend origin; the frontend POSTs both back here to receive the actual session token.

• 400 on missing/expired/mismatched code-verifier pairs.

Request

Responses

200

Successful Response

400

Bad request — malformed input or failed validation.

404

Resource not found, or hidden for tenant-enumeration safety (the caller lacks permission to know whether the resource exists).

409

Conflict — the current resource state does not allow this operation (e.g. assessment already started, email already in use).

422

Semantic validation failure — request shape was valid but contents were not.

429

Too many requests — rate limited. Retry after the window resets.

500

Internal server error — unexpected failure.