List Tools

Retrieve all tools configured for an agent.

HTTP Request

$GET https://app.resemble.ai/api/v2/agents/{agent_uuid}/tools

URL Parameters

ParameterTypeDescription
agent_uuidstringThe agent’s UUID

Example Request

$curl --request GET "https://app.resemble.ai/api/v2/agents/550e8400-e29b-41d4-a716-446655440000/tools" \
> -H "Authorization: Bearer YOUR_API_TOKEN" \
> -H "Content-Type: application/json"

Response

1{
2 "success": true,
3 "items": [
4 {
5 "id": 1,
6 "name": "check_weather",
7 "description": "Check weather for a given location",
8 "tool_type": "webhook",
9 "tool_config": {
10 "api_schema": {
11 "url": "https://api.weather.com/check",
12 "method": "GET",
13 "request_headers": {
14 "Authorization": "Bearer {{api_key}}"
15 }
16 },
17 "parameters": {
18 "location": {
19 "type": "string",
20 "description": "City name"
21 }
22 },
23 "assignments": [
24 {
25 "source": "response",
26 "attribute_name": "temperature",
27 "dynamic_variable": "current_temp"
28 }
29 ],
30 "response_timeout_secs": 30
31 },
32 "access_info": {},
33 "usage_stats": {},
34 "active": true,
35 "created_at": "2025-01-27T10:00:00Z",
36 "updated_at": "2025-01-27T10:00:00Z"
37 },
38 {
39 "id": 2,
40 "name": "end_call",
41 "description": "Use this tool to end the current phone call immediately.",
42 "tool_type": "system",
43 "tool_config": {
44 "parameters": {},
45 "assignments": [],
46 "disable_interruptions": false,
47 "force_pre_tool_speech": false
48 },
49 "access_info": {
50 "owner": "Resemble.ai",
51 "created_by": "Resemble.ai"
52 },
53 "usage_stats": {},
54 "active": true,
55 "created_at": "2025-01-27T10:00:00Z",
56 "updated_at": "2025-01-27T10:00:00Z"
57 }
58 ],
59 "count": 2
60}

Response Body

AttributeTypeDescription
successbooleanIndicates if the request was successful
itemsarrayArray of tool objects
countintegerTotal number of tools
idintegerTool ID
namestringUnique tool name (per agent)
descriptionstringTool description for LLM
tool_typestringTool type: “webhook”, “client”, or “system”
tool_configobjectTool configuration (varies by type)
access_infoobjectAccess metadata
usage_statsobjectUsage statistics
activebooleanWhether tool is enabled
created_atstringISO8601 timestamp
updated_atstringISO8601 timestamp