GET /site/sign-in

Updated Oct 2, 20261 minute read

Get how visitors sign in

The sign-in method and its settings. The OIDC client secret is never returned.

Part of Site.

Responses

Status	Description
`200`	The sign-in settings.
`401`	The bearer token is missing, revoked, or expired.
`429`	Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See rate limits.

Field	Type	Required	Description
`method`	`"median" \| "app" \| "oidc"`	No	median: Median accounts. app: a route in your app. oidc: an OpenID Connect provider.
`appUrl`	`any`	No	The sign-in route in your app, for app.
`oidc`	`object`	No
`oidc.issuer`	`string`	No
`oidc.clientId`	`string`	No
`oidc.secretHint`	`string`	No	The client secret's last four characters.
`oidcRedirectUri`	`string`	No	The redirect URI to register at your OpenID provider.
`problem`	`object`	No	Why your OpenID provider refused the last sign-in. Cleared when a sign-in works or the settings are saved.
`problem.at`	`number`	No	When it happened, in milliseconds since the epoch.
`problem.code`	`string`	No	The provider's error code, like invalid_scope.
`problem.message`	`string`	No	What to change.
`problem.detail`	`any`	No	The provider's own words.

curl https://api.median.sh/v1/site/sign-in \
  -H "Authorization: Bearer $BEARER_AUTH"