Get a conversation with its messages and turns

{
  "activeTurnId": "turn_AAAAAAAAAAAAAAAAAAAAAA",
  "createdAt": "2026-07-26T12:00:00Z",
  "id": "conv_AAAAAAAAAAAAAAAAAAAAAA",
  "messages": [
    {
      "conversationId": "conv_AAAAAAAAAAAAAAAAAAAAAA",
      "createdAt": "2026-07-26T12:00:00Z",
      "fileIds": [
        "file_AAAAAAAAAAAAAAAAAAAAAA"
      ],
      "id": "msg_AAAAAAAAAAAAAAAAAAAAAA",
      "metadata": {},
      "model": "string",
      "role": "system",
      "runId": "run_AAAAAAAAAAAAAAAAAAAAAA",
      "sequence": 1,
      "spanId": "span_AAAAAAAAAAAAAAAAAAAAAA",
      "text": "string",
      "turnId": "turn_AAAAAAAAAAAAAAAAAAAAAA"
    }
  ],
  "model": "string",
  "nextMessageCursor": "string",
  "runtimeId": "rt_AAAAAAAAAAAAAAAAAAAAAA",
  "status": "idle",
  "streamCursor": "string",
  "title": "string",
  "toolsetId": "tset_AAAAAAAAAAAAAAAAAAAAAA",
  "updatedAt": "2026-07-26T12:00:00Z"
}

Get a conversation with its durable messages and turns.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

conversationIdstringRequired

Unique conversation identifier generated by BCTRL.

Query parameters

messageCursorstringOptional

messageLimitintegerOptional<=200Defaults to 50

Response

activeTurnIdstring or null

createdAtdatetime

RFC 3339 timestamp with a UTC offset.

idstring

Unique conversation identifier generated by BCTRL.

messageslist of objects

modelstring

nextMessageCursorstring or null

runtimeIdstring

Unique runtime identifier generated by BCTRL.

statusenum

streamCursorstring

titlestring or null

toolsetIdstring or null

updatedAtdatetime

RFC 3339 timestamp with a UTC offset.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl https://api.bctrl.ai/v1/conversations/conversationId \
>	-H "Authorization: Bearer <token>"

Authentication

Path parameters

Headers

Query parameters

Response

Errors