Get conversation
One conversation with status, priority, assignment, tags and linked conversations.
GET https://cotlet.dev/api/v1/kustomer/conversations/{conversation_id}
read
Returns one conversation with its status, priority, assigned user or team, tags and the customer it belongs to. It does not include the messages, so use get_conversation_messages for the thread. Use it before a write to check that nobody changed the conversation since you searched.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id string required | string | Conversation ID from search_conversations. |
Request
curl https://cotlet.dev/api/v1/kustomer/conversations/conversation_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY" result = client.call("kustomer", "get_conversation", {"conversation_id":"conversation_8c41d2"}) const result = await cotlet.call('kustomer', 'get_conversation', {"conversation_id":"conversation_8c41d2"}); cotlet call kustomer get_conversation --data '{"conversation_id":"conversation_8c41d2"}' Example response
{
"conversation_id": "6718d2e4a1b2c3d4e5f60733",
"name": "Export fails with an error",
"status": "snoozed",
"priority": 3,
"assigned_to": "Sam Okafor",
"assigned_team": "Support",
"customer": {
"customer_id": "6712a0b4a1b2c3d4e5f60101",
"name": "Dana Whitfield"
},
"tags": [
"export",
"bug"
],
"merge_locked": false,
"created_at": "2026-10-10T08:55:00Z",
"updated_at": "2026-10-11T09:30:00Z"
}