ℹ️ You can find assign to a user,assign to an agent,assign to a team, orunassignprovided in the curl.
| Sent | Result |
|---|---|
assignedUserId only | Assigns to that user |
assignedAiAgentId only | Assigns to that agent (this can start an AI reply) |
assignedTeamId only | Assigns to that team — the next eligible team member is picked automatically |
| More than one | 403 — CN-01: "Cannot assign to more than one user, AI agent, or Team at the same time" |
None (empty body {}) | Unassigns the conversation entirely |
400 (Voxa:Team:ConversationChannelMismatch). Use List Team Assignment Targets to get the team IDs for a channel.409 (Voxa:Team:HasNoEligibleMembers).200 OK with an empty body — there's no Ok(result), just return Ok();. If you need to see the updated assignee (and which team member got it), call GET .../service-account/{conversationId} afterward.curl --location 'https://api.voxa.sa/v2/conversations/service-account/conversationId/assign' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"assignedUserId": "USER_ID"
}'{}