> ## 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 registries

> Returns registered registries in pages ordered by creation time, newest first. Page through results with the cursor query parameter returned by the previous response.



## OpenAPI

````yaml /openapi.json get /registries
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:
  /registries:
    get:
      tags:
        - Registries
      summary: List registries
      description: >-
        Returns registered registries in pages ordered by creation time, newest
        first. Page through results with the cursor query parameter returned by
        the previous response.
      parameters:
        - schema:
            type: string
            maxLength: 2048
            description: >-
              Opaque pagination token returned as nextCursor by the previous
              response. Pass it back unchanged to fetch the next page;
              null/omitted fetches the first page. Cursors encode position, not
              filters, so change filters only between pages when starting over.
          required: false
          description: >-
            Opaque pagination token returned as nextCursor by the previous
            response. Pass it back unchanged to fetch the next page;
            null/omitted fetches the first page. Cursors encode position, not
            filters, so change filters only between pages when starting over.
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
            description: >-
              Maximum number of items per page. Clamped to a maximum of 100;
              defaults to 20.
          required: false
          description: >-
            Maximum number of items per page. Clamped to a maximum of 100;
            defaults to 20.
          name: limit
          in: query
      responses:
        '200':
          description: Matching registries.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegistryListResponse'
        '400':
          description: One or more query parameters could not be parsed.
          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'
        '500':
          description: The registry list could not be loaded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    RegistryListResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/Registry'
          description: Registered registries ordered by creation time, newest first.
        nextCursor:
          type: string
          nullable: true
          description: >-
            Opaque cursor for the next page; null when there are no more items.
            Echo it back as the cursor query parameter to continue paginating.
        hasMore:
          type: boolean
          description: >-
            Whether additional pages exist. When true, nextCursor is a valid
            cursor; when false, pagination has reached the end.
      required:
        - items
        - nextCursor
        - hasMore
      description: Paginated collection envelope.
    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.
    Registry:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          description: Registry slug matching /^[A-Za-z0-9_-]+$/ used as the primary key.
        baseUrl:
          type: string
          description: Normalized absolute http(s) URL of the registry.
        lastSyncedAt:
          type: string
          nullable: true
          description: >-
            ISO-8601 timestamp of the last successful sync with the registry, or
            null when it has never been synced.
        createdAt:
          type: string
          description: ISO-8601 timestamp of when the registry was registered.
        updatedAt:
          type: string
          description: ISO-8601 timestamp of the last mutation to the record.
        authType:
          type: string
          nullable: true
          enum:
            - apiKey
            - oauth2
            - null
          description: >-
            Authentication method configured for this registry, or null when
            none is set.
        tokenExpiresAt:
          type: number
          nullable: true
          description: >-
            Epoch-ms timestamp when the cached OAuth2 access token expires, or
            null for api key auth or when no token has been fetched.
      required:
        - id
        - baseUrl
        - lastSyncedAt
        - createdAt
        - updatedAt
        - authType
        - tokenExpiresAt
      description: Record of a registered registry.

````