---
title: "Create Tool"
method: POST
path: "/ai/tools"
tags: ["Assistants"]
---

# Create Tool

`POST /ai/tools`

## Request body

- CreateSharedToolRequest — Request model for creating a shared (org-level) tool.
  - `client_side_tool` object
  - `display_name` string, required
  - `function` object
  - `handoff` object
  - `invite` object
  - `retrieval` object
  - `timeout_ms` integer
  - `type` string, required
  - `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-07** `2c2d1971907f` — 1 info
  - added the new optional request property `client_side_tool`
- **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/post.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.dev/team-telnyx/apis/telnyx-api-2/revisions/021f0faf96df?raw)