---
title: "Update Tool"
method: PATCH
path: "/v1/bots/{bot_uid}/tools/{tool_id}"
tags: ["Tools"]
---

# Update Tool

`PATCH /v1/bots/{bot_uid}/tools/{tool_id}`

Update an existing tool. Only provided fields are updated.

## Path parameters

- `bot_uid` string, required
- `tool_id` integer, required

## Request body

- UpdateToolRequest
  - `type` 'api_request' | 'function' | 'end_call' | 'transfer_call' | 'dtmf' | 'send_sms' | 'send_email' | 'call_booking' | 'check_calendar_availability' | 'check_working_hours' — The type of tool that determines its behavior and required configuration.
  - `name` string
  - `description` string
  - `url` string
  - `method` 'get' | 'post'
  - `api_timeout` integer
  - `parameters` object
  - `use_raw_schema` boolean
  - `static_params` object
  - `speak_during_execution` boolean
  - `speak_after_execution` boolean
  - `async` boolean

## Response `200`

Updated tool.

- ToolResponse
  - `id` integer — Unique numeric ID of the tool.
  - `type` 'api_request' | 'function' | 'end_call' | 'transfer_call' | 'dtmf' | 'send_sms' | 'send_email' | 'call_booking' | 'check_calendar_availability' | 'check_working_hours' — The type of tool that determines its behavior and required configuration.
  - `name` string
  - `description` string
  - `url` string
  - `method` string
  - `api_timeout` integer
  - `parameters` object
  - `use_raw_schema` boolean
  - `static_params` object
  - `speak_during_execution` boolean
  - `speak_after_execution` boolean
  - `async` boolean
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400` — Invalid request
- `404` — Tool or bot not found

---

[API](https://skmtc.net/openmicai/apis/openmic-v1-external-api.md) · [All operations](https://skmtc.net/openmicai/apis/openmic-v1-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmicai/openmic-v1-external-api/revisions/71c32e6ffd95/schema)