Sign in
instance

Create or reconfigure an OAuth2 provider.

Changed on

The issuer is immutable after create (A3): a changed issuer is refused. Profile and canonical origin are validated locally; no discovery runs. A reconfigure sweeps every session authenticated through the provider (A4).

put/api/v1/instance/oauth2-providers/{slug}

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/instance/oauth2-providers/{slug}
  • Auth: HTTP bearer

Request body

profile'github' required
display_namestring required
issuerstring required
client_idstring required
client_secretstring required
enabledboolean required
row_versioninteger

Required for reconfiguration and omitted for create. A stale or deleted row returns 409.

Response

The created or reconfigured provider.

profile'github' required
slugstring required
display_namestring required
issuerstring required
client_idstring required
redirect_uristring required
row_versioninteger required
enabledboolean required

Changes