Assign Conversation

POST

/v2/conversations/service-account/{{conversationId}}/assign

A single endpoint that handles three different operations depending on what you send: assign to a human user, assign to an AI agent, or unassign (when both fields are omitted).

ℹ️ You can find assign to a user, assign to an agent, or unassign Provided in the curl.

Behavior is determined entirely by which fields are present:

Sent	Result
`assignedUserId` only	Assigns to that user
`assignedAiAgentId` only	Assigns to that agent
Both	`400` — `BusinessException("CN-01")`: "Cannot assign to both user and AI agent at the same time"
Neither (empty body `{}`)	Unassigns the conversation entirely

Response: 200 OK with an empty body — there's no Ok(result), just return Ok();. If you need to see the updated assignee, call GET .../service-account/{conversationId} afterward.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Assigned/unassigned successfully. Empty body — no result is returned.

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

cURL

Assign to a userAssign to an AI agentUnassign

curl --location --globoff 'https://api.voxa.sa/v2/conversations/service-account/{{conversationId}}/assign' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "assignedUserId": "USER_ID"
}'

Response Example

200 - Example 1

{}

Modified at 2026-06-22 14:31:12

Create Conversation

Get Conversation