Skip to content

Start OpenID Connect sign-in

POST
/api/v1/auth/oidc/{provider}/start
curl --request POST \
--url https://example.com/api/v1/auth/oidc/example/start

Starts the OpenID Connect sign-in. No sign-in is required to start sign-in with the selected identity provider. It can return 429 if the request limit is reached. Route: /api/v1/auth/oidc/{provider}/start. Inputs: provider. Do not automatically replay this operation after an uncertain result.

provider
required
string

Configured OIDC provider name, as listed by GET /auth/options

Media typeapplication/json
object
authorization_url
required
string
state
required
string
Examplegenerated
{
"authorization_url": "example",
"state": "example"
}
Media typeapplication/json
object
code
required
string
message
required
string
Examplegenerated
{
"code": "example",
"message": "example"
}