For the complete documentation index, see llms.txt. Any page on this site can be fetched as Markdown by appending .md to its URL.

Voice agentsChat conversations

Get a finished chat conversation's transcript

GET
/v1/agent-media/chat-conversations/{conversationId}/transcript

What the visitor read, oldest first. Tool calls are not part of a transcript: only what the visitor and the agent said is included.

partial is true when the stored transcript was unavailable and this is the agent's own retained history instead — which is trimmed from the front, so the beginning of a long conversation may be missing. A trimmed transcript is returned rather than none.

Authorization

bearerAuth
AuthorizationBearer <token>

A Tandem bearer token. Requests are scoped to the organization the token belongs to; no organization header is required.

In: header

Path Parameters

conversationId*string

The conversation's visitor-facing id, or the id it reports under in Call Logs. conversationId in the response echoes whichever was sent.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agent-media/chat-conversations/string/transcript"
{  "conversationId": "string",  "agentId": "string",  "widgetId": "string",  "startedAt": "2019-08-24T14:15:22Z",  "lastActivityAt": "2019-08-24T14:15:22Z",  "endedAt": "2019-08-24T14:15:22Z",  "disposition": "string",  "transcript": [    {      "role": "user",      "text": "string",      "tool": {        "toolUseId": "string",        "name": "string",        "kind": "string",        "status": "ok",        "durationMs": 0,        "args": null,        "errorText": "string",        "httpStatus": 0,        "detail": {          "request": {            "method": "string",            "path": "string",            "baseUrl": "string",            "headers": {              "property1": "string",              "property2": "string"            },            "body": null,            "truncated": true          },          "response": {            "status": 0,            "statusText": "string",            "headers": {              "property1": "string",              "property2": "string"            },            "body": null,            "truncated": true          },          "agentSaw": null        }      },      "at": "2019-08-24T14:15:22Z"    }  ],  "partial": true}
{  "error": "string",  "message": "string",  "limit": 0,  "length": 0,  "reason": "string"}
{  "error": "string",  "message": "string",  "limit": 0,  "length": 0,  "reason": "string"}
{  "error": "string",  "message": "string",  "limit": 0,  "length": 0,  "reason": "string"}