A valid request URL is required to generate request examples{
"success": true,
"data": [
{
"id": "conv_9d2f01",
"agentId": "agt_4f9c2b7e10a24d51",
"channel": "voice",
"startedAt": "2026-07-01T15:12:00.000Z",
"durationS": 210,
"resolution": "completed",
"language": "en",
"outcome": "completed",
"goalCompleted": true,
"userTurnCount": 8,
"summary": "Caller asked about a refund; agent explained the policy and processed it.",
"primaryTopic": "Billing",
"sentiment": "neutral"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}List conversations
Returns paginated conversation history, newest first, with each row’s outcome, a one-line summary, and topic. Use the q parameter to full-text search across transcripts and summaries, and filter by date range, channel, outcome, and agent.
A valid request URL is required to generate request examples{
"success": true,
"data": [
{
"id": "conv_9d2f01",
"agentId": "agt_4f9c2b7e10a24d51",
"channel": "voice",
"startedAt": "2026-07-01T15:12:00.000Z",
"durationS": 210,
"resolution": "completed",
"language": "en",
"outcome": "completed",
"goalCompleted": true,
"userTurnCount": 8,
"summary": "Caller asked about a refund; agent explained the policy and processed it.",
"primaryTopic": "Billing",
"sentiment": "neutral"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.
- Token URL
- /api/v1/api-keys
Query Parameters
1-based page number for offset pagination. Defaults to 1 (the first page).
x >= 1Page size — how many items to return per page (1–100). Defaults to 20.
1 <= x <= 100Full-text search over the transcript and the per-call summary.
Restrict to one agent id. Omit to include every agent in the org.
Window start (RFC3339, inclusive). Omit for no lower bound.
Window end (RFC3339, exclusive). Omit for no upper bound.
Restrict to one channel.
voice, chat, sms Restrict to one terminal outcome.
completed, transferred, abandoned, no_response, opted_out, error Filter to conversations with this AI-assessed caller sentiment (transcript-derived). A conversation not yet analyzed (no sentiment) is excluded by the filter.
positive, neutral, negative, frustrated