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

# Patch service configuration

> Applies a JSON Patch document to the stored configuration, validates the result against the schema, persists it, and returns the resulting configuration payload. The patch body must be an array of RFC 6902 operations.



## OpenAPI

````yaml /cyrnel/openapi.json patch /services/{serviceId}/config
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/{serviceId}/config:
    patch:
      tags:
        - Services
      summary: Patch service configuration
      description: >-
        Applies a JSON Patch document to the stored configuration, validates the
        result against the schema, persists it, and returns the resulting
        configuration payload. The patch body must be an array of RFC 6902
        operations.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: Service identifier matching the installed manifest id.
          required: true
          description: Service identifier matching the installed manifest id.
          name: serviceId
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                anyOf:
                  - type: object
                    properties:
                      op:
                        type: string
                        enum:
                          - add
                        description: Insert a value at the target path.
                      path:
                        type: string
                        minLength: 1
                        description: JSON Pointer path to update.
                      value:
                        nullable: true
                        description: Value to insert or replace.
                    required:
                      - op
                      - path
                  - type: object
                    properties:
                      op:
                        type: string
                        enum:
                          - remove
                        description: Remove the value at the target path.
                      path:
                        type: string
                        minLength: 1
                        description: JSON Pointer path to remove.
                    required:
                      - op
                      - path
                  - type: object
                    properties:
                      op:
                        type: string
                        enum:
                          - replace
                        description: Replace the value at the target path.
                      path:
                        type: string
                        minLength: 1
                        description: JSON Pointer path to replace.
                      value:
                        nullable: true
                        description: Replacement value.
                    required:
                      - op
                      - path
                  - type: object
                    properties:
                      op:
                        type: string
                        enum:
                          - move
                        description: Move a value from one path to another.
                      path:
                        type: string
                        minLength: 1
                        description: Destination JSON Pointer path.
                      from:
                        type: string
                        minLength: 1
                        description: Source JSON Pointer path.
                    required:
                      - op
                      - path
                      - from
                  - type: object
                    properties:
                      op:
                        type: string
                        enum:
                          - copy
                        description: Copy a value from one path to another.
                      path:
                        type: string
                        minLength: 1
                        description: Destination JSON Pointer path.
                      from:
                        type: string
                        minLength: 1
                        description: Source JSON Pointer path.
                    required:
                      - op
                      - path
                      - from
                  - type: object
                    properties:
                      op:
                        type: string
                        enum:
                          - test
                        description: Assert that a path contains a value.
                      path:
                        type: string
                        minLength: 1
                        description: JSON Pointer path to inspect.
                      value:
                        nullable: true
                        description: Expected value.
                    required:
                      - op
                      - path
              description: JSON Patch operations applied in order.
      responses:
        '200':
          description: The updated configuration payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceConfigurationResponse'
        '400':
          description: >-
            The JSON Patch document was invalid or produced a configuration that
            violates the schema.
          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'
        '404':
          description: The service could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: The configuration could not be persisted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ServiceConfigurationResponse:
      type: object
      properties:
        config:
          type: object
          additionalProperties:
            nullable: true
          description: Current configuration payload stored for the service.
      required:
        - config
      description: Wrapper for a service configuration document.
    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.

````