Get conversation

The Conversation Timeline of one Conversation: messages, notes, calls, assignment changes, Topics and status.

GET https://cotlet.dev/api/v1/gladly/conversations/{conversation_id}

read

Returns the items of the timeline oldest first, each with who wrote it (customer, Agent or Gladly AI), the Channel, the text and the time. Notes are marked internal. Attachments come as file names. A Conversation that was merged into another returns the surviving one. The agent reads the timeline before it replies, tags or closes.

Parameters

Parameters: get_conversation
NameTypeDescription
conversation_id string required string Conversation ID from list_my_customers, list_conversations or get_customer.

Request

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

Example response

JSON

{
  "conversation_id": "HXRqKC5GSV-jAlq0-sxYTA",
  "status": "new",
  "assignee": null,
  "topics": [],
  "items": [
    {
      "at": "2026-10-19T21:14:00Z",
      "from": "customer",
      "channel": "email",
      "text": "Where is my parcel? I ordered on the 9th."
    }
  ]
}

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.