esper_cloud_api_SSO Connections

List SSO connections

Lists the SSO connections configured for a tenant. Use it to see every SAML or OIDC identity provider connection set up for the enterprise, along with which one is marked as default.

Returns a count and an array of connections, each with its connection ID and connection details (name, strategy, is_default). Supports filtering by is_default.

About SSO Connections

SSO connections let a tenant authenticate users through an external identity provider using SAML (samlp) or OIDC (oidc) rather than Esper's native login. A tenant can have multiple connections configured, with one designated as the default. Learn more.

Key Fields / Query Parameters

  • is_default — optional query filter to return only the connection marked as default
  • strategy — indicates whether a connection is samlp (SAML) or oidc (OIDC)

Common Use Cases

  • Auditing which identity providers are connected to a tenant
  • Looking up a connection_id before calling the edit-connection endpoint List SSO connections of a tenant. Learn more about <a target="_blank" href="https://help.esper.io/hc/en-us/articles/14266541959569-Introduction-to-User-Authentication">SSO Connections</a>.
get/authn2/v0/tenant/{enterprise_id}/connection

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/authn2/v0/tenant/{enterprise_id}/connection
  • Auth
    HTTP bearer

Path parameters

enterprise_idstring uuid required

Enterprise ID

Query parameters

is_defaultboolean

Is Default

Response

Tenant connections

countinteger

Changes

No recorded changes to this operation across all 6 revisions of this API.