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

# Install a service from a registry

> Resolves the registry source URL, downloads the definition from the returned downloadUrl, validates the manifest, and stores it. Optional adapter and id override the registry defaults. The registry source URL is stored for future updates.



## OpenAPI

````yaml /cyrnel/openapi.json post /services/install
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:
    post:
      tags:
        - Services
      summary: Install a service from a registry
      description: >-
        Resolves the registry source URL, downloads the definition from the
        returned downloadUrl, validates the manifest, and stores it. Optional
        adapter and id override the registry defaults. The registry source URL
        is stored for future updates.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ServiceInstallRequest'
      responses:
        '201':
          description: The service was installed and stored.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceCreatedResponse'
        '400':
          description: >-
            The install payload was invalid, the registry response was
            malformed, or the downloaded definition failed validation.
          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'
        '409':
          description: A service already exists with the requested id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '413':
          description: The downloaded definition exceeded the configured size limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: The service could not be installed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '502':
          description: The registry or definition file could not be downloaded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ServiceInstallRequest:
      type: object
      properties:
        source:
          type: string
          minLength: 1
          description: >-
            Registry URL to resolve for service metadata, then download the
            definition.
        adapter:
          type: string
          minLength: 1
          description: Optional adapter module identifier. Overrides registry default.
        id:
          type: string
          minLength: 1
          description: Optional service identifier. Overrides registry default.
      required:
        - source
      description: Request body used to install a service from a registry.
    ServiceCreatedResponse:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          description: Identifier assigned to the newly installed service.
      required:
        - id
      description: Response returned after a service is installed.
    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.

````