OpenAPI 3.1.0raw.githubusercontent.com2026-08-191,3412,1385.0 MB

ec31f78cf002

Assistants

Update Tool

Update the configuration of an existing AI tool.

patch/ai/tools/{tool_id}

Path parameters

tool_idstring required

Unique identifier of the tool.

Request body

client_side_toolobject
display_namestring
functionobject
handoffobject
inviteobject
retrievalobject
timeout_msinteger
typestring
webhookobject

Example request

{
  "update_dynamic_variables": {
    "description": "Collect caller details into conversation variables.",
    "name": "collect_details",
    "updatable_variables": [
      {
        "description": "The caller's full name.",
        "name": "customer_name",
        "type": "string"
      }
    ]
  }
}

Response

Successful Response

created_atstring
display_namestring
idstring required
timeout_msinteger
tool_definitionobject required
typestring required