Get a conversation transcript

Returns a conversation with its transcript, sanitized of tool calls, reasoning, and internal metadata.

GET /v1/assistant/conversations/{id}

Bearer token scope conversations:read

curl 'https://api.ferndesk.com/v1/assistant/conversations/art_01JXY9AZK4KV' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "id": "conv_01JXY9AZK4KV",
  "createdAt": "2026-01-15T18:25:43.511Z",
  "updatedAt": "2026-01-15T18:25:43.511Z",
  "status": "active",
  "source": "widget",
  "pageUrl": "https://example.com/pricing",
  "user": {
    "id": "hcusr_01JXYB3S2Y8C",
    "name": "Alice Example"
  },
  "summary": "Asked how to rotate an API key.",
  "coverage": "covered",
  "feedback": "positive",
  "escalated": false,
  "messageCount": 4,
  "transcript": [
    {
      "role": "assistant",
      "text": "You can rotate a key from Developer settings."
    }
  ],
  "references": [
    {
      "articleId": "art_01JXY9AZK4KV",
      "title": "Getting started with API keys"
    }
  ]
}

Conversation transcript

Path parameters

· 1

id string required

Identifier of the requested resource.

Path parameters

Responses