Skip to main content
GET
/
v2
/
tools
Get Tools
curl --request GET \
  --url https://tavusapi.com/v2/tools \
  --header 'x-api-key: <api-key>'
{
  "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"
    }
  ],
  "total_count": 12
}

Authorizations

x-api-key
string
header
required

Query Parameters

limit
integer
default:10

Page size. Default 10.

page
integer
default:1

1-indexed page number. Default 1.

sort
enum<string>
default:asc

Sort order by created_at. Default asc.

Available options:
asc,
desc
type
enum<string>
default:user

Which tools to return.

Available options:
user,
system,
all
name_or_uuid
string

Optional filter. Case-insensitive substring match against name, or exact match against tool_id.

Response

Tools returned

data
object[]
total_count
integer

Total number of tools matching the filters (across all pages).

Example:

12