Auth Service (v2)

Oauth Callback

Finalize an OAuth flow.

Claims the auth request, verifies the caller, exchanges the code, and saves the token. Used by both the frontend bridge and the headless flow (where a customer-owned service forwards the code/state, optionally proxied through smith-go). In all cases the auth request is user-initiated and the caller presents the end user's own credentials, so the authenticated user must match the user who initiated the flow.

post/v2/auth/callback/{provider_id}

Request

  • The document declares no server URL.
  • Auth
    • API key in header X-API-Key
    • or API key in header X-Tenant-Id
    • or HTTP bearer

Path parameters

provider_idstring required

Request body

codestring required
statestring required

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.