List conversations (v2)

All v2 conversation reads use cursor pagination. Pass limit (1–100, default 20) and an opaque cursor from the previous page's pagination.cursor. Each response returns pagination: { cursor, hasMore, total } — when cursor is null, you have reached the end.

GET /api/v2/agents/:agentId/conversations

List an agent's conversations, newest activity first.

curl "https://app.bookbag.ai/api/v2/agents/123/conversations?limit=20" \
  -H "Authorization: Bearer $BOOKBAG_API_KEY"

GET /api/v2/agents/:agentId/conversations/:conversationId

Fetch one conversation with a page of its messages (chronological within the page). Messages use the AI-SDK parts model: each part is { type: "text", text } or { type: "tool-call", toolCallId, toolName, input }.

curl https://app.bookbag.ai/api/v2/agents/123/conversations/456 \
  -H "Authorization: Bearer $BOOKBAG_API_KEY"

GET .../conversations/:conversationId/messages

List just the messages for a conversation, with the same cursor pagination and parts shape. Returns { data: [...messages], pagination }.

GET /api/v2/agents/:agentId/users/:userId/conversations

List the conversations belonging to one end-user (the userId you sent on chat). Same shape and pagination as the agent list.

curl https://app.bookbag.ai/api/v2/agents/123/users/user_8821/conversations \
  -H "Authorization: Bearer $BOOKBAG_API_KEY"

GET /api/v2/agents/:agentId/conversations/export

Export all of an agent's conversations, each with its full message list. Returns { data: [...], pagination: { cursor: null, hasMore: false, total } }. Intended for bulk/offline processing rather than paging.

curl https://app.bookbag.ai/api/v2/agents/123/conversations/export \
  -H "Authorization: Bearer $BOOKBAG_API_KEY"

Status codes

See Errors.