Skip to main content
POST
/
v2
/
pals
/
{pal_id}
/
tools
Attach Tools To PAL
curl --request POST \
  --url https://tavusapi.com/v2/pals/{pal_id}/tools \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "tool_ids": [
    "tabc123def456",
    "tdef456abc789"
  ]
}
'
{
  "data": [
    {
      "tool_id": "tabc123def456",
      "owner_id": 3675,
      "name": "get_weather",
      "description": "Get the current weather for a city",
      "parameters": {
        "type": "object",
        "properties": {
          "city": {
            "type": "string",
            "description": "City name"
          }
        },
        "required": [
          "city"
        ]
      },
      "delivery": {
        "app_message": true,
        "api": {
          "url": "https://api.example.com/v1/weather/{city}",
          "method": "POST",
          "timeout": 10,
          "headers": {
            "X-Service": "weather-bot"
          },
          "auth": {
            "token": "<string>",
            "username": "<string>",
            "password": "<string>",
            "name": "X-API-Key",
            "value": "<string>",
            "location": "header",
            "secret": "<string>",
            "token_url": "https://auth.example.com/oauth/token",
            "client_id": "<string>",
            "client_secret": "<string>",
            "scope": "<string>"
          },
          "body_template": {},
          "query_params": {
            "units": "metric"
          },
          "content_type": "application/json"
        }
      },
      "is_system_tool": false,
      "trigger_type": "in_call",
      "origin": "llm",
      "on_call": "generate_filler",
      "on_resolve": "generate_response",
      "static_filler": "Sure, let me grab that for you.",
      "created_at": "2026-05-15T10:30:00",
      "updated_at": "2026-05-15T10:30:00"
    }
  ]
}

Authorizations

x-api-key
string
header
required

Path Parameters

pal_id
string
required

The unique identifier of the PAL.

Example:

"p12345"

Body

application/json
tool_ids
string[]
required

List of tool_id values to attach. Must not be empty; at most 50 per request.

Example:
["tabc123def456", "tdef456abc789"]

Response

Tools attached

data
object[]

All tools that are now attached to the PAL, including ones that were already attached before this request.