API ReferenceConversations

Assign a conversation

Assigns the conversation to an agent or a team. Send assignee_id: null to unassign.

Authentication

api_access_tokenstring

An API key created in Settings > Developer. A user token works too and is useful while you experiment. A key is authorized at the account level: it reaches every inbox, conversation and contact in the account that issued it, and nothing outside that account.

Path parameters

account_idintegerRequired
Your account id.
conversation_idintegerRequired
The conversation's display id, as shown in the dashboard.

Request

This endpoint expects an object.
assignee_idinteger or nullOptional
The agent to assign to.
team_idinteger or nullOptional

The team to assign to. Ignored when assignee_id is present.

Response

The new assignee, or null when the conversation was unassigned.

Errors

401
Unauthorized Error
404
Not Found Error