Get analytics (series + summary) for an agent

Returns metrics series and an aggregated summary for a single agent. Series is read from Mongo; summary is cached and recomputed from Elasticsearch on miss/stale (custom date ranges always recompute).

GET /v1/agents/{agentId}/analytics

Get analytics (series + summary) for an agent

cURL

curl --request GET \
  --url https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/agents/{agentId}/analytics \
  --header 'Authorization: Bearer <token>'

200

{
  "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

BearerAuthOrgApiKeyAuth

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

200

application/json

Analytics payload.

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

agent_id · string

agent_name · string

period · object

Hide child attributes

period. type · string

period. start · string

period. end · string

period. granularity · string

summary · object

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

series · object[]

Hide child attributes

series. date · string

series. users · integer

series. conversations · integer

series. messages · integer

series. rating · number

series. cost · number

series. status · enum<string>

Available options: incomplete, complete

meta · object

Hide child attributes

meta. generated_at · string

meta. data_points · integer

meta. includes_current_interval · boolean

meta. summary_cached · boolean

meta. data_computed_at · string

meta. next_refresh_at · string