Update a conversation
PATCH
/v1/conversations/:idAuth: Secret API key (rk_sk_)
Update conversation status or assignee.
Path parameters
| Name | Type | Description |
|---|---|---|
idrequired | uuid | Conversation ID |
Body parameters
| Name | Type | Description |
|---|---|---|
status | string | open | pending | closed |
assignee_id | uuid | null | Agent user ID or null to unassign |
Responses
200Updated conversation
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"siteId": "660e8400-e29b-41d4-a716-446655440001",
"visitorId": "770e8400-e29b-41d4-a716-446655440002",
"status": "closed",
"assigneeId": null,
"createdAt": "2026-01-15T10:00:00Z",
"updatedAt": "2026-01-15T10:05:00Z"
}