Deprecated: Search Identity Providers (IDP)
This endpoint has been deprecated and may be removed in future versions of the API.
Returns a list of identity providers (social/enterprise login) configured on an instance level. e.g Google, AzureAD, etc.
- application/json
- application/grpc
- application/grpc-web+proto
Request Body required
query object
Object unspecific list filters like offset, limit and asc/desc.
offset uint64limit int64Maximum amount of events returned. The default is set to 1000 in https://github.com/zitadel/zitadel/blob/new-eventstore/cmd/zitadel/startup.yaml. If the limit exceeds the maximum configured ZITADEL will throw an error. If no limit is present the default is taken.
asc booleandefault is descending
- sortingColumn the field the result is sorted
Possible values: [
IDP_FIELD_NAME_UNSPECIFIED
,IDP_FIELD_NAME_NAME
]Default value:
IDP_FIELD_NAME_UNSPECIFIED
queries object[]
Array [idpIdQuery object
id stringidpNameQuery object
name stringmethod stringPossible values: [
TEXT_QUERY_METHOD_EQUALS
,TEXT_QUERY_METHOD_EQUALS_IGNORE_CASE
,TEXT_QUERY_METHOD_STARTS_WITH
,TEXT_QUERY_METHOD_STARTS_WITH_IGNORE_CASE
,TEXT_QUERY_METHOD_CONTAINS
,TEXT_QUERY_METHOD_CONTAINS_IGNORE_CASE
,TEXT_QUERY_METHOD_ENDS_WITH
,TEXT_QUERY_METHOD_ENDS_WITH_IGNORE_CASE
]Default value:
TEXT_QUERY_METHOD_EQUALS
defines which text equality method is used
]
Request Body required
query object
Object unspecific list filters like offset, limit and asc/desc.
offset uint64limit int64Maximum amount of events returned. The default is set to 1000 in https://github.com/zitadel/zitadel/blob/new-eventstore/cmd/zitadel/startup.yaml. If the limit exceeds the maximum configured ZITADEL will throw an error. If no limit is present the default is taken.
asc booleandefault is descending
- sortingColumn the field the result is sorted
Possible values: [
IDP_FIELD_NAME_UNSPECIFIED
,IDP_FIELD_NAME_NAME
]Default value:
IDP_FIELD_NAME_UNSPECIFIED
queries object[]
Array [idpIdQuery object
id stringidpNameQuery object
name stringmethod stringPossible values: [
TEXT_QUERY_METHOD_EQUALS
,TEXT_QUERY_METHOD_EQUALS_IGNORE_CASE
,TEXT_QUERY_METHOD_STARTS_WITH
,TEXT_QUERY_METHOD_STARTS_WITH_IGNORE_CASE
,TEXT_QUERY_METHOD_CONTAINS
,TEXT_QUERY_METHOD_CONTAINS_IGNORE_CASE
,TEXT_QUERY_METHOD_ENDS_WITH
,TEXT_QUERY_METHOD_ENDS_WITH_IGNORE_CASE
]Default value:
TEXT_QUERY_METHOD_EQUALS
defines which text equality method is used
]
Request Body required
query object
Object unspecific list filters like offset, limit and asc/desc.
offset uint64limit int64Maximum amount of events returned. The default is set to 1000 in https://github.com/zitadel/zitadel/blob/new-eventstore/cmd/zitadel/startup.yaml. If the limit exceeds the maximum configured ZITADEL will throw an error. If no limit is present the default is taken.
asc booleandefault is descending
- sortingColumn the field the result is sorted
Possible values: [
IDP_FIELD_NAME_UNSPECIFIED
,IDP_FIELD_NAME_NAME
]Default value:
IDP_FIELD_NAME_UNSPECIFIED
queries object[]
Array [idpIdQuery object
id stringidpNameQuery object
name stringmethod stringPossible values: [
TEXT_QUERY_METHOD_EQUALS
,TEXT_QUERY_METHOD_EQUALS_IGNORE_CASE
,TEXT_QUERY_METHOD_STARTS_WITH
,TEXT_QUERY_METHOD_STARTS_WITH_IGNORE_CASE
,TEXT_QUERY_METHOD_CONTAINS
,TEXT_QUERY_METHOD_CONTAINS_IGNORE_CASE
,TEXT_QUERY_METHOD_ENDS_WITH
,TEXT_QUERY_METHOD_ENDS_WITH_IGNORE_CASE
]Default value:
TEXT_QUERY_METHOD_EQUALS
defines which text equality method is used
]
- 200
- 400
- 403
- 404
- default
idps found
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
details object
totalResult uint64processedSequence uint64viewTimestamp date-timethe last time the view got updated
- sortingColumn string
Possible values: [
IDP_FIELD_NAME_UNSPECIFIED
,IDP_FIELD_NAME_NAME
]Default value:
IDP_FIELD_NAME_UNSPECIFIED
result object[]
Array [id stringdetails object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
creationDate date-timeon read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the
resourceOwner resource_owner is the organization an object belongs tostate stringPossible values: [
IDP_STATE_UNSPECIFIED
,IDP_STATE_ACTIVE
,IDP_STATE_INACTIVE
]Default value:
IDP_STATE_UNSPECIFIED
the state of the identity provider
name stringstylingType stringPossible values: [
STYLING_TYPE_UNSPECIFIED
,STYLING_TYPE_GOOGLE
]Default value:
STYLING_TYPE_UNSPECIFIED
some identity providers specify the styling of the button to their login
owner stringPossible values: [
IDP_OWNER_TYPE_UNSPECIFIED
,IDP_OWNER_TYPE_SYSTEM
,IDP_OWNER_TYPE_ORG
]Default value:
IDP_OWNER_TYPE_UNSPECIFIED
the owner of the identity provider.
- IDP_OWNER_TYPE_SYSTEM: system is managed by the ZITADEL administrators
- IDP_OWNER_TYPE_ORG: org is managed by de organization administrators
oidcConfig object
clientId stringclient id generated by the identity provider
issuer stringthe OIDC issuer of the identity provider
scopes string[]the scopes requested by ZITADEL during the request on the identity provider
displayNameMapping stringPossible values: [
OIDC_MAPPING_FIELD_UNSPECIFIED
,OIDC_MAPPING_FIELD_PREFERRED_USERNAME
,OIDC_MAPPING_FIELD_EMAIL
]Default value:
OIDC_MAPPING_FIELD_UNSPECIFIED
definition which field is mapped to the display name of the user
usernameMapping stringPossible values: [
OIDC_MAPPING_FIELD_UNSPECIFIED
,OIDC_MAPPING_FIELD_PREFERRED_USERNAME
,OIDC_MAPPING_FIELD_EMAIL
]Default value:
OIDC_MAPPING_FIELD_UNSPECIFIED
definition which field is mapped to the email of the user
jwtConfig object
jwtEndpoint stringthe endpoint where the JWT can be extracted
issuer stringthe issuer of the JWT (for validation)
keysEndpoint stringthe endpoint to the key (JWK) which is used to sign the JWT with
headerName stringthe name of the header where the JWT is sent in, default is authorization
autoRegister boolean]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2023-05-12"
},
"sortingColumn": "IDP_FIELD_NAME_UNSPECIFIED",
"result": [
{
"id": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2023-05-12",
"changeDate": "2023-05-12",
"resourceOwner": "69629023906488334"
},
"state": "IDP_STATE_UNSPECIFIED",
"name": "google",
"stylingType": "STYLING_TYPE_UNSPECIFIED",
"owner": "IDP_OWNER_TYPE_UNSPECIFIED",
"oidcConfig": {
"clientId": "string",
"issuer": "https://accounts.google.com",
"scopes": [
"openid",
"profile",
"email"
],
"displayNameMapping": "OIDC_MAPPING_FIELD_UNSPECIFIED",
"usernameMapping": "OIDC_MAPPING_FIELD_UNSPECIFIED"
},
"jwtConfig": {
"jwtEndpoint": "https://accounts.google.com",
"issuer": "https://accounts.google.com",
"keysEndpoint": "https://accounts.google.com/keys",
"headerName": "x-auth-token"
},
"autoRegister": true
}
]
}
- Schema
- Example (from schema)
Schema
details object
totalResult uint64processedSequence uint64viewTimestamp date-timethe last time the view got updated
- sortingColumn string
Possible values: [
IDP_FIELD_NAME_UNSPECIFIED
,IDP_FIELD_NAME_NAME
]Default value:
IDP_FIELD_NAME_UNSPECIFIED
result object[]
Array [id stringdetails object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
creationDate date-timeon read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the
resourceOwner resource_owner is the organization an object belongs tostate stringPossible values: [
IDP_STATE_UNSPECIFIED
,IDP_STATE_ACTIVE
,IDP_STATE_INACTIVE
]Default value:
IDP_STATE_UNSPECIFIED
the state of the identity provider
name stringstylingType stringPossible values: [
STYLING_TYPE_UNSPECIFIED
,STYLING_TYPE_GOOGLE
]Default value:
STYLING_TYPE_UNSPECIFIED
some identity providers specify the styling of the button to their login
owner stringPossible values: [
IDP_OWNER_TYPE_UNSPECIFIED
,IDP_OWNER_TYPE_SYSTEM
,IDP_OWNER_TYPE_ORG
]Default value:
IDP_OWNER_TYPE_UNSPECIFIED
the owner of the identity provider.
- IDP_OWNER_TYPE_SYSTEM: system is managed by the ZITADEL administrators
- IDP_OWNER_TYPE_ORG: org is managed by de organization administrators
oidcConfig object
clientId stringclient id generated by the identity provider
issuer stringthe OIDC issuer of the identity provider
scopes string[]the scopes requested by ZITADEL during the request on the identity provider
displayNameMapping stringPossible values: [
OIDC_MAPPING_FIELD_UNSPECIFIED
,OIDC_MAPPING_FIELD_PREFERRED_USERNAME
,OIDC_MAPPING_FIELD_EMAIL
]Default value:
OIDC_MAPPING_FIELD_UNSPECIFIED
definition which field is mapped to the display name of the user
usernameMapping stringPossible values: [
OIDC_MAPPING_FIELD_UNSPECIFIED
,OIDC_MAPPING_FIELD_PREFERRED_USERNAME
,OIDC_MAPPING_FIELD_EMAIL
]Default value:
OIDC_MAPPING_FIELD_UNSPECIFIED
definition which field is mapped to the email of the user
jwtConfig object
jwtEndpoint stringthe endpoint where the JWT can be extracted
issuer stringthe issuer of the JWT (for validation)
keysEndpoint stringthe endpoint to the key (JWK) which is used to sign the JWT with
headerName stringthe name of the header where the JWT is sent in, default is authorization
autoRegister boolean]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2023-05-12"
},
"sortingColumn": "IDP_FIELD_NAME_UNSPECIFIED",
"result": [
{
"id": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2023-05-12",
"changeDate": "2023-05-12",
"resourceOwner": "69629023906488334"
},
"state": "IDP_STATE_UNSPECIFIED",
"name": "google",
"stylingType": "STYLING_TYPE_UNSPECIFIED",
"owner": "IDP_OWNER_TYPE_UNSPECIFIED",
"oidcConfig": {
"clientId": "string",
"issuer": "https://accounts.google.com",
"scopes": [
"openid",
"profile",
"email"
],
"displayNameMapping": "OIDC_MAPPING_FIELD_UNSPECIFIED",
"usernameMapping": "OIDC_MAPPING_FIELD_UNSPECIFIED"
},
"jwtConfig": {
"jwtEndpoint": "https://accounts.google.com",
"issuer": "https://accounts.google.com",
"keysEndpoint": "https://accounts.google.com/keys",
"headerName": "x-auth-token"
},
"autoRegister": true
}
]
}
- Schema
- Example (from schema)
Schema
details object
totalResult uint64processedSequence uint64viewTimestamp date-timethe last time the view got updated
- sortingColumn string
Possible values: [
IDP_FIELD_NAME_UNSPECIFIED
,IDP_FIELD_NAME_NAME
]Default value:
IDP_FIELD_NAME_UNSPECIFIED
result object[]
Array [id stringdetails object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
creationDate date-timeon read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the
resourceOwner resource_owner is the organization an object belongs tostate stringPossible values: [
IDP_STATE_UNSPECIFIED
,IDP_STATE_ACTIVE
,IDP_STATE_INACTIVE
]Default value:
IDP_STATE_UNSPECIFIED
the state of the identity provider
name stringstylingType stringPossible values: [
STYLING_TYPE_UNSPECIFIED
,STYLING_TYPE_GOOGLE
]Default value:
STYLING_TYPE_UNSPECIFIED
some identity providers specify the styling of the button to their login
owner stringPossible values: [
IDP_OWNER_TYPE_UNSPECIFIED
,IDP_OWNER_TYPE_SYSTEM
,IDP_OWNER_TYPE_ORG
]Default value:
IDP_OWNER_TYPE_UNSPECIFIED
the owner of the identity provider.
- IDP_OWNER_TYPE_SYSTEM: system is managed by the ZITADEL administrators
- IDP_OWNER_TYPE_ORG: org is managed by de organization administrators
oidcConfig object
clientId stringclient id generated by the identity provider
issuer stringthe OIDC issuer of the identity provider
scopes string[]the scopes requested by ZITADEL during the request on the identity provider
displayNameMapping stringPossible values: [
OIDC_MAPPING_FIELD_UNSPECIFIED
,OIDC_MAPPING_FIELD_PREFERRED_USERNAME
,OIDC_MAPPING_FIELD_EMAIL
]Default value:
OIDC_MAPPING_FIELD_UNSPECIFIED
definition which field is mapped to the display name of the user
usernameMapping stringPossible values: [
OIDC_MAPPING_FIELD_UNSPECIFIED
,OIDC_MAPPING_FIELD_PREFERRED_USERNAME
,OIDC_MAPPING_FIELD_EMAIL
]Default value:
OIDC_MAPPING_FIELD_UNSPECIFIED
definition which field is mapped to the email of the user
jwtConfig object
jwtEndpoint stringthe endpoint where the JWT can be extracted
issuer stringthe issuer of the JWT (for validation)
keysEndpoint stringthe endpoint to the key (JWK) which is used to sign the JWT with
headerName stringthe name of the header where the JWT is sent in, default is authorization
autoRegister boolean]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2023-05-12"
},
"sortingColumn": "IDP_FIELD_NAME_UNSPECIFIED",
"result": [
{
"id": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2023-05-12",
"changeDate": "2023-05-12",
"resourceOwner": "69629023906488334"
},
"state": "IDP_STATE_UNSPECIFIED",
"name": "google",
"stylingType": "STYLING_TYPE_UNSPECIFIED",
"owner": "IDP_OWNER_TYPE_UNSPECIFIED",
"oidcConfig": {
"clientId": "string",
"issuer": "https://accounts.google.com",
"scopes": [
"openid",
"profile",
"email"
],
"displayNameMapping": "OIDC_MAPPING_FIELD_UNSPECIFIED",
"usernameMapping": "OIDC_MAPPING_FIELD_UNSPECIFIED"
},
"jwtConfig": {
"jwtEndpoint": "https://accounts.google.com",
"issuer": "https://accounts.google.com",
"keysEndpoint": "https://accounts.google.com/keys",
"headerName": "x-auth-token"
},
"autoRegister": true
}
]
}
invalid query
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
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
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"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
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}