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

> Returns the installed services. The query parameter is trimmed and matched against service id, name, and description. The enabled and stale parameters accept 'true' or 'false'; omit either to return all services.



## OpenAPI

````yaml /cyrnel/openapi.json get /services
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:
    get:
      tags:
        - Services
      summary: List services
      description: >-
        Returns the installed services. The query parameter is trimmed and
        matched against service id, name, and description. The enabled and stale
        parameters accept 'true' or 'false'; omit either to return all services.
      parameters:
        - schema:
            type: string
            description: Free-text query used to match service id, name, and description.
          required: false
          description: Free-text query used to match service id, name, and description.
          name: query
          in: query
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: Enabled-state filter. Omit to return all services.
          required: false
          description: Enabled-state filter. Omit to return all services.
          name: enabled
          in: query
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: >-
              Stale-state filter. true = stale only, false = fresh only. Omit to
              return all services.
          required: false
          description: >-
            Stale-state filter. true = stale only, false = fresh only. Omit to
            return all services.
          name: stale
          in: query
      responses:
        '200':
          description: Matching services.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceListResponse'
        '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 service list could not be loaded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ServiceListResponse:
      type: object
      properties:
        services:
          type: array
          items:
            $ref: '#/components/schemas/ServiceListItem'
          description: Services that match the current query filters.
      required:
        - services
      description: Collection wrapper for service listings.
    ApiErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message returned by the API.
      required:
        - error
      description: Standard error envelope returned by the HTTP error middleware.
    ServiceListItem:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          description: Service identifier used as the manifest primary key.
        name:
          type: string
          minLength: 1
          description: Display name declared by the service manifest.
        description:
          type: string
          description: Human-readable description of the service.
        hash:
          type: string
          minLength: 1
          description: Content hash of the installed manifest definition.
        source:
          type: string
          minLength: 1
          description: Install source used to fetch the manifest definition.
        adapter:
          type: string
          minLength: 1
          description: Adapter module identifier that owns the service.
        enabled:
          type: boolean
          description: Whether the service is currently enabled.
        stale:
          type: boolean
          description: >-
            Whether the service needs to be synced. Stale services cannot be
            enabled or invoked.
        effectivelyEnabled:
          type: boolean
          description: >-
            Whether the service is actually usable considering its own enabled
            state, its parent module's state, and whether the module is missing.
      required:
        - id
        - name
        - description
        - hash
        - source
        - adapter
        - enabled
        - stale
        - effectivelyEnabled
      description: Compact service summary returned by service list and detail endpoints.

````