Get a single conversation by ID

Fetch a specific conversation by its ID.

GET
/v1/conversations/{conversationId}

Path Parameters

conversationIdstring

The ID of the conversation to retrieve

conversationIdstring

The ID of the conversation to retrieve

Header Parameters

Authorization?string

Private API key in Bearer token format. Use this for server-to-server authentication. Format: Bearer sk_[live|test]_...

Match^Bearer sk_(live|test)_[a-f0-9]{64}$
X-Public-Key?string

Public API key for browser-based authentication. Can only be used from whitelisted domains. Format: pk_[live|test]_...

Match^pk_(live|test)_[a-f0-9]{64}$
X-Visitor-Id?string

Visitor ID from localStorage.

Match^[0-9A-HJKMNP-TV-Z]{26}$

Response Body

application/json

application/json

curl -X GET "https://api.cossistant.com/v1/v1/conversations/string"
{
  "conversation": {
    "id": "string",
    "title": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "visitorId": "string",
    "websiteId": "string",
    "status": "open",
    "deletedAt": null,
    "lastTimelineItem": {
      "id": "string",
      "conversationId": "string",
      "organizationId": "string",
      "visibility": "public",
      "type": "message",
      "text": "string",
      "tool": "string",
      "parts": [
        {
          "type": "text",
          "text": "string"
        }
      ],
      "userId": "string",
      "aiAgentId": "string",
      "visitorId": "string",
      "createdAt": "string",
      "deletedAt": "string"
    }
  }
}
{
  "error": "string"
}