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

# Toggle a tool

> Sets whether a tool is enabled. The parent service can still disable the tool at runtime even if the stored tool flag is true.



## OpenAPI

````yaml /cyrnel/openapi.json post /tools/{serviceId}/{toolId}/enabled
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:
  /tools/{serviceId}/{toolId}/enabled:
    post:
      tags:
        - Tools
      summary: Toggle a tool
      description: >-
        Sets whether a tool is enabled. The parent service can still disable the
        tool at runtime even if the stored tool flag is true.
      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
        - schema:
            type: string
            minLength: 1
            description: Tool identifier exposed by the service manifest.
          required: true
          description: Tool identifier exposed by the service manifest.
          name: toolId
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ToolEnabledRequest'
      responses:
        '200':
          description: Updated tool enabled state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolEnabledResponse'
        '400':
          description: The request body or path parameters were 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'
        '404':
          description: The tool could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: The tool enabled state could not be updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ToolEnabledRequest:
      type: object
      properties:
        enabled:
          type: boolean
          description: Desired enabled state for the tool.
      required:
        - enabled
      description: Request body used to toggle a tool enabled state.
    ToolEnabledResponse:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          description: Identifier of the tool whose enabled state was updated.
        serviceId:
          type: string
          minLength: 1
          description: Identifier of the service that owns the tool.
        enabled:
          type: boolean
          description: The new enabled state stored for the tool.
      required:
        - id
        - serviceId
        - enabled
      description: Response returned after toggling a tool enabled state.
    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.

````