Oauth Callback

curl --request POST \
  --url https://api.example.com/v2/auth/callback/{provider_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "state": "<string>"
}
'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

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

auth

callback

{provider_id}

Oauth Callback

curl --request POST \
  --url https://api.example.com/v2/auth/callback/{provider_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "state": "<string>"
}
'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Path Parameters

provider_id

string

required

Body

application/json

Request model for OAuth callback finalization (frontend bridge and headless).

code

string

required

state

string

required

Response

Successful Response

Oauth Callback Get

Authenticate