Skip to main content
ZStack
Recently Deleted/Recently Deleted

DiscoverIDP

IDP Discovery & Probe Probe a remote endpoint to discover and register an Identity Provider connection.

POST/api/v1/sso/idp/discover

Operation ID

DiscoverIDP

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Body Fields

  • endpoint
    StringRequired

    Endpoint URL of the Identity Provider to probe for discovery.

    Example: https://idp.example.com

  • username
    StringRequired

    Username credential used to authenticate during IDP discovery.

    Example: admin

  • password
    StringRequired

    Password credential used to authenticate during IDP discovery.

    Example: p@ssw0rd

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • id
    String

    Unique identifier of the discovered IDP provider connection.

    Example: idp-conn-001

  • providerType
    String

    Type of the discovered identity provider.

    Example: OIDC

  • endpoint
    String

    Endpoint URL of the discovered identity provider.

    Example: https://idp.example.com

  • status
    String

    Current connectivity status of the IDP provider connection.

    Example: reachable

  • discoveredAt
    String

    Discovered at

    Example: 2026-01-15T08:00:00Z

  • updatedAt
    String

    Updated at

    Example: 2026-01-15T08:00:00Z