Skip to main content
GET
Export Agent Conversations
Requires a paid workspace (hasEverPaid). Reads conversation content from the Postgres/Supabase mirror only (not Firestore). Each billable human-message session counts toward the monthly quota (50,000 included; overage billed in packs of 1,000).

Modes

Query parameters

Rate limits

Per workspace (authenticated owner). In-memory counters (single process). Response includes rateLimit.remainingHour so clients can back off before a 429. Export itself requires hasEverPaid, so live callers use the paid column. 429 when exceeded.

Examples

Newest chats (default)

Oldest first

Date range (unix seconds)

Next page

Specific conversation IDs

Example response (paginated)

Notes

  • Reads from the Supabase convos mirror (convoTurns + convoSessions), not live Firestore.
  • Default sort is most recent first (sort=desc).
  • fromTs / toTs filter on the conversation’s ts field (inclusive).
  • When paging, reuse the same sort, fromTs, and toTs with cursor.
  • Conversations with no human messages are skipped (not billable).
  • Past sessions under a convo that contain human turns are each billable.
  • Response includes usage for quota tracking.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agentId
string
required

Query Parameters

format
enum<string>
default:json
Available options:
csv,
json
convoIds
string
cursor
string
limit
integer
Required range: 1 <= x <= 100
sort
enum<string>
default:desc
Available options:
desc,
asc
fromTs
number
toTs
number

Response

Successful response

success
boolean
required
message
string
required
data
object[]
required
usage
object
rateLimit
object
hasMore
boolean
nextCursor
string | null
limit
number
mode
enum<string>
Available options:
paginated,
selected
scannedConvoCount
number
source
enum<string>
Available options:
supabase
query
object