---
title: "List Usable Edges"
method: GET
path: "/api/v1/edges/usable"
tags: ["Edge"]
---

# List Usable Edges

`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`

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.

## 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_size` integer: 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_token` string: Opaque continuation token from the previous response.

## Response `200`

EdgeServiceListUsableEdgesResponse contains currently authorized connection targets.

- C1ApiEdgeV1EdgeServiceListUsableEdgesResponse: EdgeServiceListUsableEdgesResponse contains currently authorized connection targets.
  - `edges` C1ApiEdgeV1UsableEdge[], nullable: Usable Edges ordered by application identifier, then Edge identifier.
    - `allowInferenceBearerTokens` boolean: Whether short-lived inference Bearer credentials are enabled. False when no authorized inference resource is returned.
    - `appId` string: Identifier of the application that owns this Edge.
    - `displayName` string: Human-readable name of this Edge.
    - `grantedScopes` string[], nullable: Scopes the caller currently holds on the returned resources.
    - `id` string: Identifier of this Edge.
    - `tokenAudience` string: Audience to use when exchanging a token for this Edge.
    - `tokenResources` C1ApiEdgeV1EdgeTokenResources: EdgeTokenResources names the resource URI for each supported Edge service. A field is empty when its capability is not in enabled_kinds.
      - `egress` string: Resource URI used with the egress.connect scope.
      - `inference` string: Resource URI used with the inference.models.read / inference.invoke scopes.
  - `nextPageToken` string: Continue until this token is empty, including after an empty page. Grants and configuration are evaluated live on each page, not snapshotted.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/edges/usable/get.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) - [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conductorone/apis/c1-api/revisions/fe943bedf41b?raw)