Skip to main content
GET
Get a conversation summary

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

CloudChat conversation id (UUID) or your helpdesk's ticket id — when using a ticket id, project is required

Query Parameters

project
string

Project the conversation belongs to. REQUIRED when id is a helpdesk ticket id — those are only unique within a project, so without it a ticket id cannot be resolved and answers 404. Ignored for a CloudChat conversation id, which is globally unique. Discover your projects with listMyClaudiaProjects.

Response

The conversation summary.

One conversation reduced to what an investigation reads: how it ended, when, and the turns that got there. The internal per-message processing state the hub UI reads is not here.

cloudChatId
string
required

CloudChat's own id for this conversation (UUID). Stable, and the id this endpoint resolves without a project.

Example:

"3f1c8a52-1c4e-4d0a-9a1b-2f6de2a3c111"

projectName
string
required

The ClaudIA project this conversation belongs to. Always present; it is the project your credentials were checked against to return this at all.

Example:

"acme_support"

status
string
required

Lifecycle state: Open, Resolved or Closed. Resolved means ClaudIA finished the conversation itself; read resolutionReason for how.

Example:

"Resolved"

statusAt
string
required

When the conversation entered its current status — opened, resolved or closed at (ISO-8601).

Example:

"2026-08-10T18:20:41"

createdAt
string
required

When the conversation was created (ISO-8601).

Example:

"2026-08-10T14:32:05"

messages
object[]
required

Every turn of the conversation, oldest first — customer messages, ClaudIA's replies, and any internal notes (private: true). Attachments and transcriptions are dropped.

helpdeskId
string

The id this conversation carries in your helpdesk — the ticket number your agents quote. Absent for a conversation that never reached a helpdesk. It is also the correlation key for a ticket-side investigation.

Example:

"48219"

resolutionReason
string

Why the conversation ended the way it did, when ClaudIA recorded a reason. Absent while it is still open, and for a conversation that ended without one.

Example:

"FORWARD_TO_HUMAN"

isN2
boolean

Whether the conversation was handed to a human (N2). Absent when the platform never recorded either way — read that as unknown, not as false.

Example:

false

tag
string

The resolution/classification tag the platform attached, when it attached one. Free text set per project, so treat it as a label to read, not a fixed vocabulary.

Example:

"order_status"