---
title: "Update tool"
method: PUT
path: "/v1/Tools/{id}"
---

# Update tool

`PUT /v1/Tools/{id}`

Update tool

## Path parameters

- `id` string, required

## Request body

- AssistantsV1ServiceUpdateToolRequest
  - `assistant_id` string — The Assistant ID.
  - `description` string — The description of the tool.
  - `enabled` boolean — True if the tool is enabled.
  - `meta` object — The metadata related to method, url, input_schema to used with the Tool.
  - `name` string — The name of the tool.
  - `policy` AssistantsV1ServiceCreatePolicyRequest
    - `description` string — The description of the policy.
    - `id` string — The Policy ID.
    - `name` string — The name of the policy.
    - `policy_details` unknown, required
    - `type` string — The description of the policy.
  - `type` string — The type of the tool.

## Response `200`

OK

- AssistantsV1ServiceTool
  - `account_sid` string — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Tool resource.
  - `description` string, required — The description of the tool.
  - `enabled` boolean, required — True if the tool is enabled.
  - `id` string, required — The tool ID.
  - `meta` object, required — The metadata related to method, url, input_schema to used with the Tool.
  - `name` string, required — The name of the tool.
  - `requires_auth` boolean, required — The authentication requirement for the tool.
  - `type` string, required — The type of the tool. ('WEBHOOK')
  - `url` string — The url of the tool resource.
  - `date_created` string, date-time, required — The date and time in GMT when the Tool was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, required — The date and time in GMT when the Tool was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

## Changes

- **2025-05-13** (v1) `0852198458a0` — 2 warning, 1 info
  - changed the pattern of the request property `assistant_id` from `^aia_asst_*$` to `^aia_asst_.+$`
  - changed the pattern of the request property `policy/id` from `^aia_plcy_*$` to `^aia_plcy_.+$`
  - the `id` response's property pattern was changed from `^aia_tool_*$` to `^aia_tool_.+$` for the status `200`
- **2024-09-25** (v1) `1ad87f675d4b` — 1 info
  - added the optional property `url` to the response with the `200` status

[Change history](https://skmtc.dev/twilio/apis/assistants-v1/changes/v1/Tools/:id/put.md)

---

[API](https://skmtc.dev/twilio/apis/assistants-v1.md) · [All operations](https://skmtc.dev/twilio/apis/assistants-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/assistants-v1/revisions/c5ec7f024ee9/schema)