Sign in
auth

Begin linking an external identity (OIDC purpose=link).

Changed on

An account-security mutation: verifies the pre-existing password up front and starts an OIDC link transaction bound to the acting session. Returns the IdP authorization URL; the link lands at the callback.

post/api/v1/auth/identities/link

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/auth/identities/link
  • Auth: HTTP bearer

Request body

kind'oidc' | 'oauth2'
providerstring required
proofstring required
browserboolean

Redirect the callback to the SPA done page instead of returning JSON.

Response

The IdP authorization URL for the link.

authorization_urlstring required

The IdP authorization URL to redirect the browser to.

Changes

  • 8a6e250b7105Revision changes
    • info

      added the new optional request property

  • 54b2780eec85Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status