Skip to main content
GET
/
v1
/
agents
/
{agentId}
/
analytics
Get analytics (series + summary) for an agent
curl --request GET \
  --url https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/agents/{agentId}/analytics \
  --header 'Authorization: Bearer <token>'
{
  "agent_id": "<string>",
  "agent_name": "<string>",
  "period": {
    "type": "<string>",
    "start": "<string>",
    "end": "<string>",
    "granularity": "<string>"
  },
  "summary": {},
  "series": [
    {
      "date": "<string>",
      "users": 123,
      "conversations": 123,
      "messages": 123,
      "rating": 123,
      "cost": 123
    }
  ],
  "meta": {
    "generated_at": "<string>",
    "data_points": 123,
    "includes_current_interval": true,
    "summary_cached": true,
    "data_computed_at": "<string>",
    "next_refresh_at": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Path Parameters

​
agentId
string
required
Maximum string length: 64

Query Parameters

​
period
enum<string>

Preset period. Default 30d.

Available options:
15m,
30m,
1h,
1d,
7d,
30d,
90d
Maximum string length: 16
​
start
string

ISO start (custom range). Overrides period.

Maximum string length: 64
​
end
string

ISO end (custom range, exclusive).

Maximum string length: 64
​
granularity
enum<string>

Override granularity (auto-picked from period otherwise).

Available options:
5m,
hourly,
daily
Maximum string length: 16

Response

Analytics payload.

Analytics payload (series + summary) for a single agent.

​
agent_id
string
​
agent_name
string
​
period
object
​
summary
object

Aggregated KPIs (users, engagement, quality, performance, cost, models, tools).

​
series
object[]
​
meta
object