> ## Documentation Index
> Fetch the complete documentation index at: https://actelos.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List adapters ranked for a definition kind

> Returns all installed adapter modules ranked so that adapters whose compatibility list accepts the requested kind come first, followed by incompatible adapters. The `default` field is the top-ranked compatible and active adapter, or null when none is available. Omit `kind` to receive all adapters unranked.



## OpenAPI

````yaml /openapi.json get /services/install/adapters
openapi: 3.0.0
info:
  title: Cyrnel API
  description: >-
    Cyrnel is a universal layer that connects AI agents and LLM applications to
    any external service, API, or device regardless of protocol or standard. It
    acts as an adaptive bridge between your AI and the outside world, enabling
    seamless integrations through code execution, async operation handling, and
    built-in observability and security controls.
  version: 1.0.0
servers:
  - url: http://localhost:9371
security: []
paths:
  /services/install/adapters:
    get:
      tags:
        - Services
      summary: List adapters ranked for a definition kind
      description: >-
        Returns all installed adapter modules ranked so that adapters whose
        compatibility list accepts the requested kind come first, followed by
        incompatible adapters. The `default` field is the top-ranked compatible
        and active adapter, or null when none is available. Omit `kind` to
        receive all adapters unranked.
      parameters:
        - schema:
            type: string
            description: >-
              Definition kind to rank against, e.g. 'openapi@3.0'. Omit to list
              all adapters.
          required: false
          description: >-
            Definition kind to rank against, e.g. 'openapi@3.0'. Omit to list
            all adapters.
          name: kind
          in: query
      responses:
        '200':
          description: Ranked adapter list.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InstallAdaptersResponse'
        '400':
          description: The 'kind' query parameter was invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: A bearer token was required but missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '429':
          description: >-
            Rate limit exceeded. The request was throttled. Check Retry-After
            header.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Maximum requests allowed in the current window.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: integer
              description: Unix timestamp when the window resets.
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitErrorResponse'
        '500':
          description: The adapter list could not be loaded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    InstallAdaptersResponse:
      type: object
      properties:
        default:
          type: string
          nullable: true
          description: >-
            Default adapter id (compatible and active). Null when no compatible
            adapter is available.
        adapters:
          type: array
          items:
            $ref: '#/components/schemas/AdapterRankListItem'
          description: >-
            All installed adapter modules, ranked so compatible adapters come
            first.
      required:
        - default
        - adapters
    ApiErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message returned by the API.
        code:
          type: string
          description: >-
            Stable machine-readable error code (e.g. invalid_cursor,
            cursor_expired).
      required:
        - error
      description: Standard error envelope returned by the HTTP error middleware.
    RateLimitErrorResponse:
      type: object
      properties:
        error:
          type: string
          enum:
            - rate_limit_exceeded
          description: Error code identifying rate-limit rejection.
        message:
          type: string
          description: Human-readable message with retry instructions.
        retryAfter:
          type: integer
          minimum: 0
          exclusiveMinimum: true
          description: Number of seconds to wait before retrying.
      required:
        - error
        - message
        - retryAfter
      description: Error body returned when a request is rate-limited (HTTP 429).
    AdapterRankListItem:
      type: object
      properties:
        id:
          type: string
          description: Adapter module identifier.
        name:
          type: string
          description: Human-readable adapter module name.
        compatible:
          type: boolean
          description: Whether the adapter accepts the requested definition kind.
        active:
          type: boolean
          description: Whether the adapter module is currently installed and active.
        isBuiltin:
          type: boolean
          description: >-
            Whether the adapter is a built-in (canonical) module, preferred on
            ranking ties.
      required:
        - id
        - name
        - compatible
        - active
        - isBuiltin

````