Skip to content
StratumStratum Docs

List the external providers the sign-in page offers..

GET
/v1/iam/sign-in-providers
Code sample: Shell / cURL
curl --request GET \
  --url https://stratum.example.com/v1/iam/sign-in-providers

Public. The console renders one button per item. Disabled providers are not listed, and the list is empty when the control plane has no OIDC callback origin configured, so a button never leads to a 503.

Responses

Section titled “Responses”

200

Section titled “200”

Enabled providers.

Media typeapplication/json

Complete: every enabled provider. Bounded by the install’s own configuration, so not paginated.

object
items
required
Array<object>

. One external identity provider the console’s sign-in card offers as a button. Only enabled providers are listed, and only when the control plane has OIDC configured.

object
name
required

The provider’s slug (/v1/iam/oidc/{name}/...).

string
/^[a-z0-9-]{1,64}$/
displayName
required
string
buttonLabel
required

Text for the button, Sign in with <displayName>.

string
loginUrl
required

Path that starts the sign-in, /v1/iam/oidc/{name}/login. Navigate the browser to it (top-level, not fetch) with post_login set to the console route that finishes the flow, for example /v1/iam/oidc/corp/login?post_login=%2Foidc-complete.

string

Example generated

{
  "items": [
    {
      "name": "example",
      "displayName": "example",
      "buttonLabel": "example",
      "loginUrl": "example"
    }
  ]
}