> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleartalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a tool



## OpenAPI

````yaml post /tools/{toolID}/update
openapi: 3.0.0
info:
  title: ClearTalk API
  description: The ClearTalk API Documentation
  version: '1.0'
  contact:
    name: Developer Support
    email: devsupport@cleartalk.ai
servers:
  - url: https://api.cleartalk.ai
    description: ClearTalk AI API Server
security: []
tags: []
paths:
  /tools/{toolID}/update:
    post:
      tags:
        - Tools
      summary: Update a tool
      operationId: ToolsController_updateTool
      parameters:
        - name: toolID
          required: true
          in: path
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateToolDto'
      responses:
        '200':
          description: Tool updated successfully
          content:
            application/json:
              schema:
                example:
                  id: tool_123
                  name: confirmationNumber
                  description: Here's your case reference number
                  speech: one moment GP
                  url: https://staging.cleartalk.ai/randomNumber
                  method: GET
                  headers:
                    Content-Type: application/json
                  body: {}
                  query: {}
                  input_schema: {}
                  response: {}
                  timeout: 30
        '400':
          description: Invalid request payload
        '404':
          description: Tool not found
      security:
        - apiKey: []
components:
  schemas:
    UpdateToolDto:
      type: object
      properties:
        name:
          type: string
          description: Name of the tool
          example: confirmationNumber
        description:
          type: string
          description: Description of the tool
          example: Here's your case reference number
        speech:
          type: string
          description: Speech response for the tool
          example: one moment GP
        url:
          type: string
          description: URL endpoint for the tool
          example: https://staging.cleartalk.ai/randomNumber
        method:
          type: string
          description: HTTP method for the tool
          enum:
            - GET
            - POST
            - PUT
            - DELETE
            - PATCH
          example: GET
        headers:
          type: object
          description: HTTP headers for the request
          example:
            Content-Type: application/json
        body:
          type: object
          description: Request body parameters
          example: {}
        query:
          type: object
          description: Query parameters
          example: {}
        input_schema:
          type: object
          description: Input schema for the tool
          example: {}
        response:
          type: object
          description: Response schema for the tool
          example: {}
        timeout:
          type: number
          description: Timeout in seconds
          example: 30
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key for authentication

````