List Agents
Retrieve all agents for the authenticated team.
HTTP Request
$ GET https://app.resemble.ai/api/v2/agents
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| phone_number | string | Filter agents by associated phone number (optional) |
| advanced | boolean | Include detailed agent configuration (default: false) |
Example Request
$ curl --request GET "https://app.resemble.ai/api/v2/agents" \ > -H "Authorization: Bearer YOUR_API_TOKEN" \ > -H "Content-Type: application/json"
Example Request with Query Parameters
$ curl --request GET "https://app.resemble.ai/api/v2/agents?advanced=true&phone_number=%2B14155551234" \ > -H "Authorization: Bearer YOUR_API_TOKEN" \ > -H "Content-Type: application/json"
Response
1 { 2 "success": true, 3 "items": [ 4 { 5 "agent": { 6 "name": "Customer Support Agent", 7 "uuid": "550e8400-e29b-41d4-a716-446655440000", 8 "languages": ["en-US"], 9 "dynamic_variables": { 10 "customer_name": "John Doe", 11 "account_id": "12345" 12 }, 13 "created_at": "2025-01-15T10:30:00Z", 14 "updated_at": "2025-01-20T14:45:00Z", 15 "last_active_at": "2025-01-27T09:00:00Z", 16 "calls_today": 15, 17 "status": "active" 18 }, 19 "asr": { 20 "provider": "deepgram", 21 "model": "nova-2", 22 "user_input_audio_format": "pcm_16000", 23 "keywords": ["resemble", "account", "billing"] 24 }, 25 "tts": { 26 "voice_uuid": "abc123", 27 "voice_name": "Professional Voice" 28 }, 29 "turn": { 30 "turn_timeout": 7, 31 "silence_end_call_timeout": -1, 32 "mode": "silence" 33 }, 34 "llm": { 35 "prompt": "You are a helpful customer support agent.", 36 "provider": "openai", 37 "model": "gpt-4o", 38 "reasoning_effort": null, 39 "temperature": 0.3, 40 "timezone": "America/New_York", 41 "built_in_tools": {} 42 }, 43 "phone_numbers": [ 44 { 45 "id": 1, 46 "phone_number": "+14155551234", 47 "label": "Support Line", 48 "supports_inbound": true, 49 "supports_outbound": false, 50 "provider": "twilio", 51 "outbound_trunk": {}, 52 "inbound_trunk": {}, 53 "created_at": "2025-01-15T10:30:00Z", 54 "updated_at": "2025-01-15T10:30:00Z" 55 } 56 ], 57 "tools_count": 3, 58 "webhooks_count": 2 59 } 60 ], 61 "count": 1 62 }
Response Body (Basic Mode - advanced=false)
| Attribute | Type | Description |
|---|---|---|
| success | boolean | Indicates if the request was successful |
| items | array | Array of agent objects |
| count | integer | Total number of agents |
| agent.name | string | Name of the agent |
| agent.uuid | string | Unique identifier for the agent |
| agent.languages | array | Supported language codes (currently only “en-US”) |
| agent.dynamic_variables | object | Key-value pairs for runtime variable substitution |
| agent.created_at | string | ISO8601 timestamp of creation |
| agent.updated_at | string | ISO8601 timestamp of last update |
| agent.last_active_at | string | ISO8601 timestamp of last activity (null if never active) |
| agent.calls_today | integer | Number of calls today |
| agent.status | string | Agent status: “active” or “inactive” |
| tools_count | integer | Number of tools configured |
| webhooks_count | integer | Number of webhooks configured |
Response Body (Advanced Mode - advanced=true)
In advanced mode, tools_count and webhooks_count are replaced with:
| Attribute | Type | Description |
|---|---|---|
| tools | array | Full array of tool objects with configurations |
| knowledge_bases | array | Array of knowledge base configurations |
| webhooks | array | Full array of webhook objects with configurations |
