COconductorone
Edge

List Usable Edges

Changed on

List connection targets the calling person can currently use, without administrative configuration. Supports the person's own human session and device DPoP session; service principals are refused.

get/api/v1/edges/usable

Request

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

Query parameters

kind'EDGE_CAPABILITY_KIND_UNSPECIFIED' | 'EDGE_CAPABILITY_KIND_EGRESS' | 'EDGE_CAPABILITY_KIND_INFERENCE'

Restrict resources and scopes to this capability. UNSPECIFIED returns all authorized capabilities; unknown enum values are rejected.

page_sizeinteger

Maximum number of tenant Edge candidates evaluated per page. Zero uses the default of 100; maximum 100. A page may be empty with a continuation.

page_tokenstring

Opaque continuation token from the previous response.

Response

EdgeServiceListUsableEdgesResponse contains currently authorized connection targets.

nextPageTokenstring

Continue until this token is empty, including after an empty page. Grants and configuration are evaluated live on each page, not snapshotted.

Changes