Skip to main content
GET
/
conversations
Error
A valid request URL is required to generate request examples
{
  "success": true,
  "data": [
    {
      "id": "<string>",
      "agentId": "<string>",
      "startedAt": "2023-11-07T05:31:56Z",
      "durationS": 123,
      "language": "<string>",
      "callerNumber": "<string>",
      "goalCompleted": true,
      "userTurnCount": 123,
      "summary": "<string>",
      "primaryTopic": "<string>",
      "sentimentScore": 123
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123,
    "nextCursor": "<string>"
  },
  "message": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

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.

Query Parameters

page
integer
default:1
Required range: x >= 1
limit
integer
default:20
Required range: 1 <= x <= 100
q
string

Full-text search over the transcript and the per-call summary.

agentId
string
from
string<date-time>
to
string<date-time>
channel
enum<string>
Available options:
voice,
chat
outcome
enum<string>
Available options:
completed,
transferred,
abandoned,
error

Response

200 - application/json

Paginated conversation history.

success
boolean
required
data
object[]
required
pagination
object
required
message
string
errors
object[]