Dispatch Agent

Dispatch an agent to start handling conversations. This creates a conversation session and connects the agent to the orchestrator.

HTTP Request

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

URL Parameters

Parameter	Type	Description
uuid	string	The unique identifier of the agent

Example Request

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

Response (Success)

1 {
2   "success": true,
3   "item": {
4     "success": true,
5     "agent_id": 123,
6     "conversation_uuid": "conv-550e8400-e29b-41d4-a716-446655440000",
7     "session_id": "sess-abc123def456",
8     "status": "dispatched",
9     "message": "Agent dispatched successfully"
10   },
11   "message": "Agent dispatched successfully"
12 }

Response (Error)

1 {
2   "success": false,
3   "errors": {
4     "agent": ["Agent ASR configuration is missing"],
5     "dispatch": ["Failed to dispatch agent: Connection timeout"]
6   },
7   "message": "Failed to dispatch agent"
8 }

Response Body

Attribute	Type	Description
success	boolean	Indicates if the request was successful
item.agent_id	integer	The agent’s database ID
item.conversation_uuid	string	Unique identifier for the conversation session
item.session_id	string	Session identifier for the orchestrator
item.status	string	Dispatch status
message	string	Human-readable message

Validation Rules

Before dispatch, the agent must have all required configurations:

ASR configuration: Provider and model must be set
TTS configuration: Voice must be linked
Turn configuration: Turn-taking settings must be configured
LLM configuration: LLM provider and model must be set

If any required configuration is missing, the dispatch will fail with a detailed error message indicating which component is incomplete.

Common Error Scenarios

Missing ASR Configuration

1 {
2   "success": false,
3   "errors": {
4     "agent": ["Agent ASR configuration is missing"]
5   },
6   "message": "Failed to dispatch agent"
7 }

Missing Voice

1 {
2   "success": false,
3   "errors": {
4     "agent": ["Agent TTS configuration is missing"]
5   },
6   "message": "Failed to dispatch agent"
7 }

Orchestrator Connection Error

1 {
2   "success": false,
3   "errors": {
4     "dispatch": ["Failed to dispatch agent: Connection timeout"]
5   },
6   "message": "Failed to dispatch agent"
7 }