Error
A valid request URL is required to generate request examples{
"success": true,
"data": [
{
"agentId": "agt_4f9c2b7e10a24d51",
"agentName": "Front Desk",
"status": "published",
"totalCalls": 640,
"answerRate": 0.95,
"containmentRate": 0.81,
"lastCallAt": "2026-07-01T16:22:00.000Z",
"spendUsd": 96.2
},
{
"agentId": "agt_8b1d3c",
"agentName": "After Hours",
"status": "published",
"totalCalls": 0,
"answerRate": 0,
"containmentRate": 0,
"spendUsd": 0
}
]
}{
"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
Get analytics per agent
Returns one rollup row per active agent with total calls, answer rate, containment rate, last call time, and spend. Agents with no calls in the selected window are still included with zeros. Filter by date range and channel.
GET
/
analytics
/
by-agent
Error
A valid request URL is required to generate request examples{
"success": true,
"data": [
{
"agentId": "agt_4f9c2b7e10a24d51",
"agentName": "Front Desk",
"status": "published",
"totalCalls": 640,
"answerRate": 0.95,
"containmentRate": 0.81,
"lastCallAt": "2026-07-01T16:22:00.000Z",
"spendUsd": 96.2
},
{
"agentId": "agt_8b1d3c",
"agentName": "After Hours",
"status": "published",
"totalCalls": 0,
"answerRate": 0,
"containmentRate": 0,
"spendUsd": 0
}
]
}{
"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.
Query Parameters
Window start (RFC3339, inclusive). Defaults to the last 30 days.
Window end (RFC3339, exclusive). Defaults to now.
Restrict to one channel. Omit for all.
Available options:
voice, chat, sms