---
title: "Get tool"
method: GET
path: "/v1/Tools/{id}"
---

# Get tool

`GET /v1/Tools/{id}`

Get tool

## Path parameters

- `id` string, required

## Response `200`

OK

- AssistantsV1ServiceToolWithPolicies
  - `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.
  - `policies` AssistantsV1ServicePolicy[] — The Policies associated with the tool.
    - `id` string — The Policy ID.
    - `name` string — The name of the policy.
    - `description` string — The description of the policy.
    - `account_sid` string — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Policy resource.
    - `user_sid` string — The SID of the User that created the Policy resource.
    - `type` string, required — The type of the policy.
    - `policy_details` object, required — The details of the policy based on the type.
    - `date_created` string, date-time — The date and time in GMT when the Policy was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `date_updated` string, date-time — The date and time in GMT when the Policy was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

## Changes

- **2026-04-14** (v1) `bd3fb6f26e74` — 1 breaking, 13 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/assistants.v1.service.tool, subschema #2` from the response body `allOf` list for the response status `200`
  - added the optional property `account_sid` to the response with the `200` status
  - added the optional property `policies` to the response with the `200` status
  - …10 more
- **2025-05-13** (v1) `0852198458a0` — 2 info
  - the `allOf[#/components/schemas/assistants.v1.service.tool]/id` response's property pattern was changed from `^aia_tool_*$` to `^aia_tool_.+$` for the status `200`
  - the `allOf[subschema #2]/policies/items/id` response's property pattern was changed from `^aia_plcy_*$` to `^aia_plcy_.+$` for the status `200`
- **2024-09-25** (v1) `1ad87f675d4b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/twilio/apis/assistants-v1/changes/v1/Tools/:id/get.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)