Start the upstream OAuth authorization for a pending flow

Reconstructs the upstream provider’s authorize URL for a pending OAuth flow. The auth-landing page redirects the browser to that URL; the user completes upstream auth; the upstream provider redirects back to /api/oauth/callback, which exchanges the code for tokens server-side and stores them against the flow’s identity.

Returns 410 if the flow is no longer pending (expired / completed / failed). The caller should restart the original action to get a fresh flow.

GET /api/oauth/per-user/flows/{id}/start

Error

A valid request URL is required to generate request examples

200

{
  "authorize_url": "<string>"
}

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

id · string · required

Flow row ID

Response

200

application/json

Authorize URL

authorize_url · string · required

Where to send the browser to complete upstream OAuth