Unassign User from Conversation

DELETE/v1/conversations/{id}/unassign-user

Removes the currently assigned user from the conversation. The conversation remains open but has no assigned agent.

Path Parameters

idstring required

Conversation ID

Example:60f1234567890abcdef12345

Responses

Body

success_codeenum: 200 | 201•Numeric success code matching the HTTP response status. required

Example:200

messagestring required

Example:OK

detailsobject required

dataobject required

conversationIdstring

Example:60f1234567890abcdef12345

assigneeUserstring or null•Assigned user id after unassign; always null on success.

metaobject

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

error_codeinteger•Numeric error code matching the HTTP response status. required

Example:400

messagestring required

detailsobject•Validation errors are returned as a field-to-messages map; other errors may use arbitrary keys. required

Request Sample:Shell / cURL

1
2
3
4

curl --request DELETE \
  --url "https://api-stg.bevatelcloud.com/v1/conversations/{id}/unassign-user" \
  --header "Authorization: Bearer <YOUR_API_KEY>" \
  --header "Content-Type: application/json"

Response Example

1
2
3
4
5
6
7
8
9
10

{
  "success_code": 200,
  "message": "OK",
  "details": {},
  "data": {
    "conversationId": "60f1234567890abcdef12345",
    "assigneeUser": "string"
  },
  "meta": {}
}