Update conversation status

Close completed conversations or reopen them for follow-ups.

PATCH /whatsapp/conversations/{conversation_id}

cURL

close

curl --request PATCH \ --url https://api.kapso.ai/platform/v1/whatsapp/conversations/{conversation_id} \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <api-key>' \ --data ' { "whatsapp_conversation": { "status": "ended" } } '

200

ended

{ "data": { "id": "c63ced48-1283-4d55-8c8d-930f525aa0e5", "phone_number": "14155550123", "status": "ended", "last_active_at": "2025-07-16T09:45:00Z", "created_at": "2025-06-01T12:00:00Z", "updated_at": "2025-07-16T09:45:00Z", "metadata": {}, "phone_number_id": "1234567890", "kapso": { "contact_name": "Alicia", "messages_count": 42, "last_message_id": "wamid.HBgMMTIzNDU2", "last_message_type": "text", "last_message_timestamp": "2025-07-16T09:40:00Z", "last_message_text": "Thanks!", "last_inbound_at": "2025-07-16T09:35:10Z", "last_outbound_at": "2025-07-16T09:40:00Z" } } }

Authorizations

X-API-Key · string · header · required

Path Parameters

conversation_id · string<uuid> · required

Body

application/json

whatsapp_conversation · object · required

Show child attributes

Response

200

application/json

Conversation updated

data · object · required

Show child attributes