Skip to main content
GET
Get usage for one tool

Authorizations

Authorization
string
header
required

Workspace API key (wk_) with the Workspace read API scope enabled.

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.

Response fields for this endpoint are not modelled in the spec yet. See the Workspace API guide for the shapes.