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

Parameters: get_conversation
NameTypeDescription
conversation_id string required string Conversation ID from search_conversations.

Request

cURL
curl https://cotlet.dev/api/v1/kustomer/conversations/conversation_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("kustomer", "get_conversation", {"conversation_id":"conversation_8c41d2"})
Node.js
const result = await cotlet.call('kustomer', 'get_conversation', {"conversation_id":"conversation_8c41d2"});
CLI
cotlet call kustomer get_conversation --data '{"conversation_id":"conversation_8c41d2"}'

Example response

JSON

{
  "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"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.