> ## Documentation Index
> Fetch the complete documentation index at: https://www.c1.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Usable Edges

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



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/edges/usable
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/edges/usable:
    get:
      tags:
        - Edge
      summary: List Usable Edges
      description: |-
        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.
      operationId: c1.api.edge.v1.EdgeService.ListUsableEdges
      parameters:
        - in: query
          name: kind
          schema:
            description: >-
              Restrict resources and scopes to this capability. UNSPECIFIED
              returns all
               authorized capabilities; unknown enum values are rejected.
            enum:
              - EDGE_CAPABILITY_KIND_UNSPECIFIED
              - EDGE_CAPABILITY_KIND_EGRESS
              - EDGE_CAPABILITY_KIND_INFERENCE
            type: string
            x-speakeasy-unknown-values: allow
        - in: query
          name: page_size
          schema:
            description: >-
              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.
            format: int32
            type: integer
        - in: query
          name: page_token
          schema:
            description: Opaque continuation token from the previous response.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.edge.v1.EdgeServiceListUsableEdgesResponse
          description: >-
            EdgeServiceListUsableEdgesResponse contains currently authorized
            connection targets.
components:
  schemas:
    c1.api.edge.v1.EdgeServiceListUsableEdgesResponse:
      description: >-
        EdgeServiceListUsableEdgesResponse contains currently authorized
        connection targets.
      properties:
        edges:
          description: >-
            Usable Edges ordered by application identifier, then Edge
            identifier.
          items:
            $ref: '#/components/schemas/c1.api.edge.v1.UsableEdge'
          type:
            - array
            - 'null'
        nextPageToken:
          description: |-
            Continue until this token is empty, including after an empty page.
             Grants and configuration are evaluated live on each page, not snapshotted.
          type: string
      title: Edge Service List Usable Edges Response
      type: object
      x-speakeasy-name-override: EdgeServiceListUsableEdgesResponse
    c1.api.edge.v1.UsableEdge:
      description: >-
        UsableEdge is the secret-free connection target authorized for the
        calling person.
         It excludes policy, routes, credential configuration, and administrative identities.
      properties:
        allowInferenceBearerTokens:
          description: >-
            Whether short-lived inference Bearer credentials are enabled. False
            when
             no authorized inference resource is returned.
          type: boolean
        appId:
          description: Identifier of the application that owns this Edge.
          type: string
        displayName:
          description: Human-readable name of this Edge.
          type: string
        grantedScopes:
          description: Scopes the caller currently holds on the returned resources.
          items:
            type: string
          type:
            - array
            - 'null'
        id:
          description: Identifier of this Edge.
          type: string
        tokenAudience:
          description: Audience to use when exchanging a token for this Edge.
          type: string
        tokenResources:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeTokenResources'
            - type: 'null'
      title: Usable Edge
      type: object
      x-speakeasy-name-override: UsableEdge
    c1.api.edge.v1.EdgeTokenResources:
      description: >-
        EdgeTokenResources names the resource URI for each supported Edge
        service.
         A field is empty when its capability is not in enabled_kinds.
      properties:
        egress:
          description: Resource URI used with the egress.connect scope.
          type: string
        inference:
          description: >-
            Resource URI used with the inference.models.read / inference.invoke
            scopes.
          type: string
      title: Edge Token Resources
      type: object
      x-speakeasy-name-override: EdgeTokenResources
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````