Skip to main content

Begin an OIDC identity-linking ceremony

POST 

/api/v1/auth/identities/oidc/:provider_id/start

Requires a normal authenticated session and a same-origin cookie request. The verified callback can only add a credential to that exact recently authenticated local account; it cannot admit a new account or issue a replacement session.

Request​

Responses​

Browser authorization URL and correlation cookie

Response Headers
    Cache-Control

    Always no-store

    Set-Cookie

    Host-only HttpOnly OIDC correlation cookie

    X-Request-Id

    Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.