Update a conversation▾
PATCH

Update a conversation

Close, reopen, assign or tag a thread.

Closing a thread does not close the WhatsApp session window — the contact can still reply, which reopens it and fires conversation.reopened.

PATCH/v1/conversations/{wa_id}

Path parameters

wa_idstringrequired

Digits-only WhatsApp id, or conv_….

Body parameters

statusenum

Thread status.

openpendingclosed

assignee_idstring

User id, or null to return it to the queue.

tagsarray

Replaces the thread's tags.

curl -X PATCH https://api.sendport.tech/v1/conversations/{wa_id} \
  -H "Authorization: Bearer $SENDPORT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"closed","assignee_id":null}'

Responses

200OK
{
  "object": "conversation",
  "id": "conv_01JZQ3F8X0QG7T2S4N8V1PZAKD",
  "contact": { "wa_id": "201005550123", "name": "Nadia Haddad" },
  "channel_number": "+15550100200",
  "status": "closed",
  "assignee": { "id": "usr_01JZQ0A1", "name": "Amina R.", "email": "amina@example.com" },
  "unread_count": 2,
  "session_expires_at": "2026-09-07T03:41:02.000Z",
  "last_message_at": "2026-09-06T09:41:02.000Z",
  "created_at": "2026-08-30T10:02:11.000Z"
}
401Unauthorized
{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No API key provided.",
    "doc_url": "https://sendport.tech/docs/errors#missing_api_key",
    "request_id": "req_9f3c2a7b41de08c5b2e6"
  }
}
Try itsandbox
PreviousList conversation messagesNextList contacts