---
title: "Update Tool"
method: PATCH
path: "/ai/tools/{tool_id}"
tags: ["Assistants"]
---

# Update Tool

`PATCH /ai/tools/{tool_id}`

## Path parameters

- `tool_id` string, required

## Request body

- UpdateSharedToolRequest — Request model for updating a shared tool.
  - `display_name` string
  - `function` object
  - `handoff` object
  - `invite` object
  - `retrieval` object
  - `timeout_ms` integer
  - `type` string
  - `webhook` object

## Response `200`

Successful Response

- SharedToolResponse
  - `created_at` string
  - `display_name` string
  - `id` string, required
  - `timeout_ms` integer
  - `tool_definition` object, required
  - `type` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-02** `224ed0d8a5c3` — 1 warning
  - removed the request property `client_side_tool`

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/ai/tools/:tool_id/patch.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/224ed0d8a5c3/schema)