Sign in
Auth Settings

List Identity Providers

Retrieves the identity providers available within the organization. This operation provides information about various identity providers for SAML or OIDC authentication integrations.

get/v3/identity-providers

Query parameters

Filter identity providers returned in the response.

Response

A collection of identity providers. This response contains a collection of identity providers, which may include both OIDC and SAML identity providers.

idstring uuid

Contains a unique identifier used for this resource.

type'oidc' | 'saml'

Specifies the type of identity provider.

enabledboolean

Indicates whether the identity provider is enabled. Only one identity provider can be active at a time, such as SAML or OIDC.

login_pathstring

The path used for initiating login requests with the identity provider.

created_atstring date-time

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time

An ISO-8601 timestamp representation of entity update date.

Example response

[
  {
    "id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
    "type": "oidc",
    "enabled": true,
    "login_path": "myapp",
    "config": {
      "issuer_url": "https://konghq.okta.com/oauth2/default",
      "client_id": "YOUR_CLIENT_ID",
      "client_secret": "YOUR_CLIENT_SECRET",
      "claim_mappings": {
        "name": "name",
        "email": "email",
        "groups": "groups"
      }
    },
    "created_at": "2022-11-04T20:10:06.927Z",
    "updated_at": "2022-11-04T20:10:06.927Z"
  }
]

Changes

Changed in 8 of the 75 revisions of this API.4213

  • ccc33535acb52See the full diff
    • ▲

      the items/config/oneOf[subschema #2: SAML Identity Provider Config]/callback_url response's property type/format changed from string/path to string/uri for status 200

      response-property-type-changed

    • ▲

      the items/config/oneOf[subschema #2: SAML Identity Provider Config]/sp_metadata_url response's property type/format changed from string/path to string/uri for status 200

      response-property-type-changed

  • 8715e5b7ad961See the full diff
    • ○

      added the optional write-only property items/config/oneOf[subschema #1: OIDC Identity Provider Config]/client_secret to the response with the 200 status

      response-optional-write-only-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 396c243e49dc1See the full diff
    • ●

      for the query request parameter filter, the type/format of property type was changed from string/ to /

      request-parameter-property-type-changed

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 3c0154b2053a3See the full diff
    • ○

      the email response's property default value email was added for the status 200

      response-property-default-value-added

    • ○

      the groups response's property default value groups was added for the status 200

      response-property-default-value-added

    • ○

      the name response's property default value name was added for the status 200

      response-property-default-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 6333a0d3b0953See the full diff
    • ○

      the email response's property default value email was removed for the status 200

      response-property-default-value-removed

    • ○

      the groups response's property default value groups was removed for the status 200

      response-property-default-value-removed

    • ○

      the name response's property default value name was removed for the status 200

      response-property-default-value-removed

    This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 76b0fefddb0d3See the full diff
    • ○

      the email response's property default value email was added for the status 200

      response-property-default-value-added

    • ○

      the groups response's property default value groups was added for the status 200

      response-property-default-value-added

    • ○

      the name response's property default value name was added for the status 200

      response-property-default-value-added

  • 9a3d26a0008812See the full diff
    • ▲

      added OIDCIdentityProviderConfig SAMLIdentityProviderConfig to the items/config response property oneOf list for the response status 200

      response-property-one-of-added

    • ○

      added the optional property items/login_path to the response with the 200 status

      response-optional-property-added

    • ○

      removed schemas-OIDCIdentityProviderConfig schemas-SAMLIdentityProviderConfig from the items/config response property oneOf list for the response status 200

      response-property-one-of-removed

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 0aead68de7b0111See the full diff
    • ▲

      added schemas-OIDCIdentityProviderConfig schemas-SAMLIdentityProviderConfig to the items/config response property oneOf list for the response status 200

      response-property-one-of-added

    • ●

      removed the optional property items/login_path from the response with the 200 status

      response-optional-property-removed

    • ○

      removed OIDCIdentityProviderConfig SAMLIdentityProviderConfig from the items/config response property oneOf list for the response status 200

      response-property-one-of-removed

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog