Skip to main content
POST
/
api
/
v1
/
conversations
/
{conversationId}
/
assign
Assign an agent
curl --request POST \
  --url https://api.inbox.adraa.ai/api/v1/conversations/{conversationId}/assign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "cmbxgwq1e0000ph01i0j1k2l3"
}
'
{
  "success": true,
  "conversationId": "cmbxgz9pq0003ph01m4n5o6p7",
  "assignment": {
    "agentId": "cmbxgwq1e0000ph01i0j1k2l3",
    "agentNickname": "sara",
    "assignedAt": "2026-06-12T10:30:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

Workspace API token created in Settings → API. Tokens start with adraa_.

Path Parameters

​
conversationId
string
required

ID of the conversation. Visible in the console URL when a conversation is open: app.inbox.adraa.ai/<workspace>/conversations/<conversationId>.

Example:

"cmbxgz9pq0003ph01m4n5o6p7"

Body

application/json
​
agentId
string
required

ID of the agent to assign (list agents with GET /api/v1/agents), or ai to assign the workspace's AI agent.

Example:

"cmbxgwq1e0000ph01i0j1k2l3"

Response

Agent assigned

​
success
boolean
Example:

true

​
conversationId
string
Example:

"cmbxgz9pq0003ph01m4n5o6p7"

​
assignment
object

The resulting assignment.