Skip to main content
GET
Get usage for one tool

Authorizations

Authorization
string
header
required

Workspace API key (wk_). GET endpoints require the Workspace read API scope, POST endpoints the Workspace write API scope.

Path Parameters

agentId
string
required

The agent id.

toolName
string
required

The tool name to look up (e.g. 'get_skills', 'send_email', 'http_request').

Query Parameters

since
string

ISO date string. Only count usage after this timestamp. Defaults to 30 days ago.

limit
integer

Max recent calls to return (default 10).

Required range: 1 <= x <= 50

Response

Success. Empty result sets are also 200.

Newest call first, capped by limit.

toolName
string
required
lastUsedAt
string | null
required

Null when the tool was never called in the window.

totalCount
number
required

Calls in chats plus calls in trigger runs, since since.

since
string
required

The window start actually used — 30 days ago when not given.

recentCalls
object[]
required