Skip to content
Zerker Gateway

Summarize one agent's activity

GET
/v1/agent-events/summary
curl --request GET \
  --url 'https://example.com/v1/agent-events/summary?agent_id=example' \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
agent_id
required
string
since
string format: date-time

Inclusive RFC3339 start. Defaults to 24 hours before until.

until
string format: date-time

Exclusive RFC3339 end. Defaults to the current time.

Responses

Section titled “Responses”

200

Section titled “200”

Compact activity summary for a window of at most 31 days.

Media typeapplication/json
object
schema
required
string
Allowed values: zerker.agent-event-summary.v1
agent_id
required
string
since
required
string format: date-time
until
required
string format: date-time
summary
required
object
sessions
required
integer format: int64
tool_calls
required
integer format: int64
tools_succeeded
required
integer format: int64
tools_failed
required
integer format: int64
tool_duration_ms
required
integer format: int64
input_tokens
required
integer format: int64
output_tokens
required
integer format: int64
cost_usd
required
number format: double
cost_known
required

True only when at least one usage event supplied an explicit cost value.

boolean
last_event_at

Latest received event for this agent across all time; absent until an adapter connects.

string format: date-time
Example
{
  "schema": "zerker.agent-event-summary.v1"
}

400

Section titled “400”

Invalid agent or time window.

Media typeapplication/json

The uniform error body for all 4xx responses that carry one.

object
error
required

A coarse, caller-safe message. Never contains internal state (invariant

string
Examplegenerated
{
  "error": "example"
}

401

Section titled “401”

Missing or invalid bearer token, or the token’s tenant/user claims are absent. No body.

404

Section titled “404”

No resource with this ID exists in the caller’s tenant.

Media typeapplication/json

The uniform error body for all 4xx responses that carry one.

object
error
required

A coarse, caller-safe message. Never contains internal state (invariant

string
Examplegenerated
{
  "error": "example"
}

500

Section titled “500”

An unexpected server-side error. No body (internal detail is never returned to callers, invariant