Skip to main content
PUT
Update mid call tool
This endpoint allows you to update an existing mid call tool. All fields are optional - only provide the fields you want to update.

Path Parameters

id
integer
required
The unique identifier of the tool to update

Body Parameters

name
string
Tool name - must contain only lowercase letters and underscores, and start with a letter
description
string
Detailed explanation of when and how the AI should use this tool (max 255 characters)
endpoint
string
Valid URL of the API endpoint to call
method
string
HTTP method: GET, POST, PUT, PATCH, or DELETE
timeout
integer
Request timeout in seconds (1-30)
headers
array
HTTP headers to send with the request (replaces existing headers)
schema
array
Parameters schema (replaces existing schema)

Response fields

message
string
Success message
data
object
The updated tool object with all current values

Managing Tool Assignments

To attach or detach this tool from assistants, use the Assistant API:
  • Create Assistant - Use the tool_ids parameter to attach tools when creating an assistant
  • Update Assistant - Use the tool_ids parameter to manage which tools are assigned to an assistant