Get conversations (v1)
GET /agents/:id/conversations and GET /conversations/:id — list an agent's conversations and read a single conversation with its full message transcript.
View as MarkdownRead an agent's conversation history. These dashboard-backed reads return up to the 100 most recent conversations for the list, and the full transcript for a single conversation. For cursor-paginated, AI-SDK-shaped reads, use API v2 conversations.
GET /agents/:id/conversations
List the most recent conversations for an agent (newest first, capped at 100).
| Param | In | Type | Notes |
|---|---|---|---|
| id | path | integer | The agent id. |
curl https://app.bookbag.ai/agents/123/conversations \ -H "Authorization: Bearer $BOOKBAG_API_KEY"
GET /conversations/:id
Fetch a single conversation with its full, ordered message transcript including citations, ratings, and per-answer confidence.
| Param | In | Type | Notes |
|---|---|---|---|
| id | path | integer | The conversation id. |
curl https://app.bookbag.ai/conversations/456 \ -H "Authorization: Bearer $BOOKBAG_API_KEY"
Status codes
| Status | Meaning |
|---|---|
| 200 | Success. |
| 401 | Missing or invalid credentials. |
| 403 | No access to this workspace. |
| 404 | Conversation not found or not in your workspace. Body: { success:false, error:{ code:"not_found", message } }. |
See Errors for the envelope.