List Tools
Retrieve all tools configured for an agent.
HTTP Request
$ GET https://app.resemble.ai/api/v2/agents/{agent_uuid}/tools
URL Parameters
| Parameter | Type | Description |
|---|---|---|
| agent_uuid | string | The 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
| Attribute | Type | Description |
|---|---|---|
| success | boolean | Indicates if the request was successful |
| items | array | Array of tool objects |
| count | integer | Total number of tools |
| id | integer | Tool ID |
| name | string | Unique tool name (per agent) |
| description | string | Tool description for LLM |
| tool_type | string | Tool type: “webhook”, “client”, or “system” |
| tool_config | object | Tool configuration (varies by type) |
| access_info | object | Access metadata |
| usage_stats | object | Usage statistics |
| active | boolean | Whether tool is enabled |
| created_at | string | ISO8601 timestamp |
| updated_at | string | ISO8601 timestamp |
