v1

latestOpenAPI 3.0.32026-07-267015229.9 KB

PAL Tools

Attach Tools To PAL

Attach one or more tools (by tool_id) to a PAL. A PAL can have at most 50 attached tools.

Attaching a tool that is already attached is idempotent - it is reported in the response alongside any newly-attached tools.

post/v2/pals/{pal_id}/tools

Request body

tool_idsstring[] required

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

Example request

{
  "tool_ids": [
    "tabc123def456",
    "tdef456abc789"
  ]
}

Response

Tools attached

Example response

{
  "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": {
        "api": {
          "url": "https://api.example.com/v1/weather/{city}",
          "headers": {
            "X-Service": "weather-bot"
          },
          "auth": {
            "name": "X-API-Key",
            "token_url": "https://auth.example.com/oauth/token"
          },
          "query_params": {
            "units": "metric"
          },
          "content_type": "application/json"
        }
      },
      "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"
    }
  ]
}