Get Agent | Resemble | Documentation

Retrieve a specific agent by UUID.

HTTP Request

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

URL Parameters

Parameter	Type	Description
uuid	string	The unique identifier of the agent

Query Parameters

Parameter	Type	Description
advanced	boolean	Include detailed configuration (default: false)

Example Request

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

Example Request with Advanced Mode

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

Response

1 {
2   "success": true,
3   "item": {
4     "agent": {
5       "name": "Customer Support Agent",
6       "uuid": "550e8400-e29b-41d4-a716-446655440000",
7       "languages": ["en-US"],
8       "dynamic_variables": {
9         "customer_name": "John Doe"
10       },
11       "created_at": "2025-01-15T10:30:00Z",
12       "updated_at": "2025-01-20T14:45:00Z",
13       "last_active_at": null,
14       "calls_today": 0,
15       "status": "inactive"
16     },
17     "asr": {
18       "provider": "deepgram",
19       "model": "nova-2",
20       "user_input_audio_format": "pcm_16000",
21       "keywords": []
22     },
23     "tts": {
24       "voice_uuid": "abc123",
25       "voice_name": "Professional Voice"
26     },
27     "turn": {
28       "turn_timeout": 7,
29       "silence_end_call_timeout": -1,
30       "mode": "silence"
31     },
32     "llm": {
33       "prompt": "You are a helpful assistant.",
34       "provider": "openai",
35       "model": "gpt-4o",
36       "reasoning_effort": null,
37       "temperature": 0.3,
38       "timezone": null,
39       "built_in_tools": {}
40     },
41     "phone_numbers": [],
42     "tools_count": 2,
43     "webhooks_count": 1
44   }
45 }

Response Body

Attribute	Type	Description
success	boolean	Indicates if the request was successful
item	object	Agent object with full configuration
agent	object	Core agent information
asr	object	ASR configuration
tts	object	TTS configuration
turn	object	Turn-taking configuration
llm	object	LLM configuration
phone_numbers	array	Linked phone numbers
tools_count	integer	Number of tools (basic mode)
webhooks_count	integer	Number of webhooks (basic mode)

In advanced mode, tools_count and webhooks_count are replaced with full tools, knowledge_bases, and webhooks arrays.