Skip to main content
GET
ListAgentCalls

Path Parameters

tenant_meta.namespace
string
required

Namespaces are a way to organize organizational units into virtual groupings of resources. Namespaces must be a fully qualified name, for example, the child namespace of namespace "endor.prod" called "app" is called "endor.prod.app".

agent_id
string
required

The agent whose calls to return; matches EndorAgent.id in the catalog.

Query Parameters

page_size
integer<int32>

Max rows to return. Defaults to 100 when zero.

page_token
string

Opaque continuation token from a prior response.

decision
string

Optional exact-match filter on decision. Accepted values: allowed, denied (case-sensitive); any other value is rejected.

operation
string

Optional exact-match filter on operation. Accepted values: READ, LIST, CREATE, UPDATE, DELETE, UPSERT, EXECUTE (case-sensitive); any other value is rejected.

Response

A successful response.

ListAgentCallsResponse is served at GET /v1/namespaces/{tenant_meta.namespace}/agent-telemetry/agents/{agent_id}/calls.

Cursor-only pagination: there is intentionally NO exact total. An exact COUNT over a filtered event scan is a per-open cost trap with no product value; this surface returns recent calls, not a precise count. The pre-aggregated per-agent count is AgentActivity.calls. More pages remain when next_page_token is non-empty; it is an opaque keyset cursor, never an offset.

agent_id
string

Echo of the requested agent id.

agent_identity
string

The agent's {name}@{version} identity; unset for an unregistered agent.

calls
object[]

The calls, newest first.

next_page_token
string

Opaque keyset cursor; empty when there are no more pages.

schema_version
string

Schema version of this response envelope.