Skip to main content
Get Tool Activity

Authorizations

X-API-Key
string
header
required

Headers

authorization
string | null
X-API-Key
string | null

Path Parameters

tool_uuid
string
required

Query Parameters

days
integer
default:7
Required range: 1 <= x <= 30
failed_only
boolean
default:false
workflow_id
integer | null
limit
integer
default:200
Required range: 1 <= x <= 1000

Response

Successful Response

GET /tools/{uuid}/activity.

window_days
integer
required
since
string<date-time>
required
runs_scanned
integer
required
truncated
boolean
required

True when more runs matched than were read (oldest left out).

health
ToolHealth · object
required

A tool's calls over a time window, rebuilt read-only from the runs' stored logs.

Each call is a tool.invocation log event whose executorRef names the tool (tool:<uuid>:<function>). Result and duration come from the native.tool_record event stored when that call's result went back to the voice model (the same pairing as the run's Activity view). Native voice path only.

total_rows
integer
required

Rows matching the filters before the limit.

causes
Causes · object

Failed calls by cause.

rows
ToolCallRow · object[]

Newest first.