Error
A valid request URL is required to generate request examples{
"success": true,
"data": [
{
"id": "conv_9d2f01",
"agentId": "agt_4f9c2b7e10a24d51",
"channel": "voice",
"startedAt": "2026-07-11T18:02:00.000Z",
"durationS": 184,
"resolution": "completed",
"language": "en",
"outcome": "completed",
"goalCompleted": true,
"summary": "Caller asked about a duplicate charge; agent explained and resolved.",
"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>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Observe
List conversations for a topic
Returns the paginated list of conversations grouped under a single topic, so you can drill into the calls behind it.
GET
/
agents
/
{agentId}
/
topics
/
{clusterId}
/
conversations
Error
A valid request URL is required to generate request examples{
"success": true,
"data": [
{
"id": "conv_9d2f01",
"agentId": "agt_4f9c2b7e10a24d51",
"channel": "voice",
"startedAt": "2026-07-11T18:02:00.000Z",
"durationS": 184,
"resolution": "completed",
"language": "en",
"outcome": "completed",
"goalCompleted": true,
"summary": "Caller asked about a duplicate charge; agent explained and resolved.",
"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>"
}
]
}{
"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.
FlowClient Credentials
- Token URL
- /api/v1/api-keys
Scopes1
analytics:read
Read the Observe history list, per-agent analytics (the answer-rate summary), the raw knowledge-gap list, and the metric catalog + per-metric queries + metric drill-downs.
Path Parameters
The agent this resource is scoped to (the UUID returned by createAgent / listAgents).
The topic-cluster id to drill into (the clusterId returned by listAgentTopics).
Query Parameters
1-based page number for offset pagination. Defaults to 1 (the first page).
Required range:
x >= 1Page size — how many items to return per page (1–100). Defaults to 20.
Required range:
1 <= x <= 100