Get the current active identity providers
GET/v2/settings/login/idps
Return the current active identity providers for the requested context
Request​
Query Parameters
Responses​
- 200
- 403
- 404
- default
OK
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object
the last time the projection got updated
identityProviders
object[]
Possible values: [IDENTITY_PROVIDER_TYPE_UNSPECIFIED
, IDENTITY_PROVIDER_TYPE_OIDC
, IDENTITY_PROVIDER_TYPE_JWT
, IDENTITY_PROVIDER_TYPE_LDAP
, IDENTITY_PROVIDER_TYPE_OAUTH
, IDENTITY_PROVIDER_TYPE_AZURE_AD
, IDENTITY_PROVIDER_TYPE_GITHUB
, IDENTITY_PROVIDER_TYPE_GITHUB_ES
, IDENTITY_PROVIDER_TYPE_GITLAB
, IDENTITY_PROVIDER_TYPE_GITLAB_SELF_HOSTED
, IDENTITY_PROVIDER_TYPE_GOOGLE
, IDENTITY_PROVIDER_TYPE_SAML
, IDENTITY_PROVIDER_TYPE_APPLE
]
Default value: IDENTITY_PROVIDER_TYPE_UNSPECIFIED
options
object
Enable if users should be able to link an existing ZITADEL user with an external account.
Enable if users should be able to create a new account in ZITADEL when using an external account.
Enable if a new account in ZITADEL should be created automatically when login with an external account.
Enable if a the ZITADEL account fields should be updated automatically on each login.
Possible values: [AUTO_LINKING_OPTION_UNSPECIFIED
, AUTO_LINKING_OPTION_USERNAME
, AUTO_LINKING_OPTION_EMAIL
]
Default value: AUTO_LINKING_OPTION_UNSPECIFIED
Enable if users should get prompted to link an existing ZITADEL user to an external account if the selected attribute matches.
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"timestamp": "2024-12-20T16:04:44.287Z"
},
"identityProviders": [
{
"id": "string",
"name": "string",
"type": "IDENTITY_PROVIDER_TYPE_UNSPECIFIED",
"options": {
"isLinkingAllowed": true,
"isCreationAllowed": true,
"isAutoCreation": true,
"isAutoUpdate": true,
"autoLinking": "AUTO_LINKING_OPTION_UNSPECIFIED"
}
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object
the last time the projection got updated
identityProviders
object[]
Possible values: [IDENTITY_PROVIDER_TYPE_UNSPECIFIED
, IDENTITY_PROVIDER_TYPE_OIDC
, IDENTITY_PROVIDER_TYPE_JWT
, IDENTITY_PROVIDER_TYPE_LDAP
, IDENTITY_PROVIDER_TYPE_OAUTH
, IDENTITY_PROVIDER_TYPE_AZURE_AD
, IDENTITY_PROVIDER_TYPE_GITHUB
, IDENTITY_PROVIDER_TYPE_GITHUB_ES
, IDENTITY_PROVIDER_TYPE_GITLAB
, IDENTITY_PROVIDER_TYPE_GITLAB_SELF_HOSTED
, IDENTITY_PROVIDER_TYPE_GOOGLE
, IDENTITY_PROVIDER_TYPE_SAML
, IDENTITY_PROVIDER_TYPE_APPLE
]
Default value: IDENTITY_PROVIDER_TYPE_UNSPECIFIED
options
object
Enable if users should be able to link an existing ZITADEL user with an external account.
Enable if users should be able to create a new account in ZITADEL when using an external account.
Enable if a new account in ZITADEL should be created automatically when login with an external account.
Enable if a the ZITADEL account fields should be updated automatically on each login.
Possible values: [AUTO_LINKING_OPTION_UNSPECIFIED
, AUTO_LINKING_OPTION_USERNAME
, AUTO_LINKING_OPTION_EMAIL
]
Default value: AUTO_LINKING_OPTION_UNSPECIFIED
Enable if users should get prompted to link an existing ZITADEL user to an external account if the selected attribute matches.
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"timestamp": "2024-12-20T16:04:44.287Z"
},
"identityProviders": [
{
"id": "string",
"name": "string",
"type": "IDENTITY_PROVIDER_TYPE_UNSPECIFIED",
"options": {
"isLinkingAllowed": true,
"isCreationAllowed": true,
"isAutoCreation": true,
"isAutoUpdate": true,
"autoLinking": "AUTO_LINKING_OPTION_UNSPECIFIED"
}
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object
the last time the projection got updated
identityProviders
object[]
Possible values: [IDENTITY_PROVIDER_TYPE_UNSPECIFIED
, IDENTITY_PROVIDER_TYPE_OIDC
, IDENTITY_PROVIDER_TYPE_JWT
, IDENTITY_PROVIDER_TYPE_LDAP
, IDENTITY_PROVIDER_TYPE_OAUTH
, IDENTITY_PROVIDER_TYPE_AZURE_AD
, IDENTITY_PROVIDER_TYPE_GITHUB
, IDENTITY_PROVIDER_TYPE_GITHUB_ES
, IDENTITY_PROVIDER_TYPE_GITLAB
, IDENTITY_PROVIDER_TYPE_GITLAB_SELF_HOSTED
, IDENTITY_PROVIDER_TYPE_GOOGLE
, IDENTITY_PROVIDER_TYPE_SAML
, IDENTITY_PROVIDER_TYPE_APPLE
]
Default value: IDENTITY_PROVIDER_TYPE_UNSPECIFIED
options
object
Enable if users should be able to link an existing ZITADEL user with an external account.
Enable if users should be able to create a new account in ZITADEL when using an external account.
Enable if a new account in ZITADEL should be created automatically when login with an external account.
Enable if a the ZITADEL account fields should be updated automatically on each login.
Possible values: [AUTO_LINKING_OPTION_UNSPECIFIED
, AUTO_LINKING_OPTION_USERNAME
, AUTO_LINKING_OPTION_EMAIL
]
Default value: AUTO_LINKING_OPTION_UNSPECIFIED
Enable if users should get prompted to link an existing ZITADEL user to an external account if the selected attribute matches.
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"timestamp": "2024-12-20T16:04:44.288Z"
},
"identityProviders": [
{
"id": "string",
"name": "string",
"type": "IDENTITY_PROVIDER_TYPE_UNSPECIFIED",
"options": {
"isLinkingAllowed": true,
"isCreationAllowed": true,
"isAutoCreation": true,
"isAutoUpdate": true,
"autoLinking": "AUTO_LINKING_OPTION_UNSPECIFIED"
}
}
]
}
Returned when the user does not have permission to access the resource.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Returned when the resource does not exist.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}