PUT
/v1/admin/conversations/{id}/status
Set Conversation Status
Force-resolve the conversation (supervisor action), optionally with tags and a wrap-up note.
curl -X PUT https://api.{cluster}.{platform}.voiger.io/v1/admin/conversations/{id}/status \
-H "Cookie: sid=$VOIGER_SESSION" \
-H "x-workspace-code: your-workspace-code" \
-H "x-csrf-token: $CSRF_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"status": "resolved",
"tags": [
"billing"
],
"note": "Customer confirmed delivery date."
}'
const res = await fetch("https://api.{cluster}.{platform}.voiger.io/v1/admin/conversations/{id}/status", {
method: "PUT",
credentials: "include",
headers: { "x-workspace-code": "your-workspace-code" },
headers: { "Content-Type": "application/json", "x-csrf-token": csrf },
body: JSON.stringify({
"status": "resolved",
"tags": [
"billing"
],
"note": "Customer confirmed delivery date."
}),
})
const data = await res.json()
Parameters
x-workspace-code
string
required
in header
x-csrf-token
string
required
in header
id
string
required
in path
tags▾
array
The conversation's own tags. The full current set: the resolve dialog opens pre-filled from it, resolving by hand replaces it, and a wrap-up resolution adds to it. The client resolves names and colours for `tag_id` against its replicated tag store.
channels▾
object
Every medium this conversation has used, as a map keyed by channel -- not just the one its latest activity rode. Maintained as the activities are written, so a client can filter and badge a thread without reading its timeline. A map rather than a list because each value is a channel's own object, empty today and room for detail later. Empty for a thread that has only routing events.
assigned_at
string | null
json · 200
{
"conversation": {
"id": "f108702c-05e4-48ee-9398-b1cebdcb566b",
"tags": [
{
"tag_id": "3f1c0a7e-9b24-4f1a-8c55-2d6e7a9f0b31",
"actor": {
"type": "agent",
"reference_id": "6feb3aa5-e6d0-4931-aadd-5edd828bdb95"
},
"created_at": "2026-09-24T08:15:00.000000Z"
}
],
"status": "open",
"state": "assigned",
"created_at": "2026-09-24T08:12:20.921558Z",
"updated_at": "2026-09-24T08:15:00.000000Z",
"participants": [
{
"id": "6a0f1fae-0d73-4e24-a018-aea09c396cb7",
"type": "agent",
"reference_id": "6feb3aa5-e6d0-4931-aadd-5edd828bdb95",
"role": null,
"assigned_at": "2026-09-24T08:13:00.000000Z",
"left_at": null
},
{
"id": "4bf20c21-717f-4e76-a1fb-bdb1cf174b82",
"type": "customer",
"reference_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"role": null,
"assigned_at": null,
"left_at": null
}
],
"latest_activity": {
"id": "f49a462f-20a9-4147-8253-1b019548bddc",
"type": "text",
"channel": "whatsapp",
"created_at": "2026-09-24T08:14:00.000000Z",
"direction": "inbound",
"status": "received",
"external_id": "wamid.HBgMOTE5OTQ1OTIzMjc4",
"actor": {
"type": "customer",
"phone": "+919945923278"
},
"from": {
"type": "customer",
"phone": "+919945923278"
},
"cli": {
"id": "c0nnect0-0000-4000-8000-000000000001",
"phone": "+971542959591"
},
"data": {
"text": "Hi, where is my parcel?",
"sent_at": "2026-09-24T08:13:58.000000Z"
}
}
}
}