/identity-providersList Identity Providers
Returns the paginated list of end-user federation provider configurations attached to the project.
Results follow standard cursor pagination.
Requires PROJECT_ADMIN.
| cursor | query | The Omit it for the first page. |
| limit | query | The most configurations to return. Default 50; values above 100 are lowered to 100. |
| projectSlug * | path | The project's slug: the path segment after It is unique within the org. |
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | Success | |
| 401 | K9O_SESSION_EXPIRED | Your session has expired; authenticate again to continue. |
| 403 | K9O_ACCESS_DENIED | You do not have the required role to list identity providers for this project. |
| 410 | K9O_SLUG_GONE | The project slug in the URL has been renamed; update your integration to use the current slug. |
| data * | object[] | One page of configurations, newest first. |
| id * | string | The configuration's id ( |
| projectId * | string | The project's id ( |
| idpProvider * | "google" | "github" | "microsoft" | "oidc" | "saml" | "scim" | "ldap" | "active_directory" | "apple" | "facebook" | "twitter" | The identity provider type. It cannot be changed after create: delete the configuration and create a new one instead. |
| displayName * | string | A name for this configuration, 1 to 256 characters. |
| clientId * | string | The client (application) id registered with the provider. |
| clientSecretSet * | boolean | Whether a client secret is stored. The secret itself is never returned. Always false for providers that use none ( |
| redirectUri * | string | The callback the provider redirects to, derived by the platform. Register it with the provider. |
| metadataUrl * | any | The provider's discovery or metadata URL, or null when none is set. |
| One of: string | ||
| or: null | ||
| attributeMap * | object | Maps platform claim names to the provider's attribute names, as Read by the LDAP and Active Directory also read Default |
| enabled * | boolean | Whether end users can sign in with this provider. |
| allowedRedirectUris * | string[] | The web origins SDK sign-in may return the end user to. Empty means SDK sign-in is refused. |
| nativeRedirectUris * | string[] | The native-app redirect URIs. Empty when there are none. |
| directoryPullEnabled * | boolean | Whether the scheduled directory sync is on. |
| directorySyncSubject * | any | The admin user the directory sync acts as, or null when unset. |
| One of: string | ||
| or: null | ||
| directorySyncIntervalMins * | any | Minutes between directory syncs, or null when unset. |
| One of: integer | ||
| or: null | ||
| directorySyncLastRunAt * | any | When the directory sync last ran, or null if it never has. |
| One of: string <date-time> | ||
| or: null | ||
| directorySyncLastStatus * | any | How the last directory sync ended, or null if it never ran. |
| One of: "ok" | ||
| or: "error" | ||
| or: "disabled_skipped" | ||
| or: "credential_absent" | ||
| or: "audit_write_failed" | ||
| or: null | ||
| createdAt * | string <date-time> | When the configuration was created. |
| updatedAt * | any | When it last changed, or null if it never has. |
| One of: string <date-time> | ||
| or: null | ||
| meta * | any | Request metadata, plus |
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.org.gate.idpProviders.list()Showing example in TypeScript
{
"data": [
{
"id": "string",
"projectId": "string",
"idpProvider": "google",
"displayName": "string",
"clientId": "string",
"clientSecretSet": false,
"redirectUri": "string",
"metadataUrl": "string",
"enabled": false,
"allowedRedirectUris": [
"string"
],
"nativeRedirectUris": [
"string"
],
"directoryPullEnabled": false,
"directorySyncSubject": "string",
"directorySyncIntervalMins": 0,
"directorySyncLastRunAt": "string",
"directorySyncLastStatus": "ok",
"createdAt": "string",
"updatedAt": "string"
}
]
}