External Client

NOTE: Searches external client grants for all users

Changed on

Search returns external client grants for all users in the tenant. Request a modest page_size (≤25) to keep responses small.

post/api/v1/search/iam/external_clients

Request

  • Base URL
    https://example.conductor.one
  • URL
    https://example.conductor.one/api/v1/search/iam/external_clients
  • Auth
    HTTP bearer and OAuth 2
    Client credentials
    Token URL: /auth/v1/token

Request body

clientIdUrlsstring[] nullable

Exact-match filter on client_id values (e.g., CIMD URLs). Returns only grants whose client_id matches one of these values.

pageSizeinteger

The pageSize field.

pageTokenstring

The pageToken field.

querystring

Free-text search on client_name and user display name

wellKnownClientsstring[] nullable

Filter by well-known client type (e.g., CLAUDE_CODE, CURSOR, etc.)

Response

Successful response

nextPageTokenstring

The nextPageToken field.

Changes

    • warning

      added the new CLIENT_ID_TYPE_STATIC enum value to the // response property for the response status

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • warning

      added the new CLIENT_ID_TYPE_APP enum value to the // response property for the response status