Sign in

v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03124241726.5 KB
Tools

Get tool context breakdown

Returns where the tool is used, broken down by a dimension: model and provider attribute the tool's traces via their chat spans; tag reads tags on the tool-call spans themselves.

get/v1/projects/{projectSlug}/tools/{toolName}/context

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier)

toolNamestring required

Tool name. URL-encode names containing special characters.

Tool name. URL-encode names containing special characters.

Query parameters

fromIsostring date-time

Lower bound (inclusive) of the time range. Defaults to 7 days before toIso.

Lower bound (inclusive) of the time range. Defaults to 7 days before toIso.

toIsostring date-time

Upper bound (inclusive) of the time range. Defaults to now.

Upper bound (inclusive) of the time range. Defaults to now.

dimension'model' | 'provider' | 'tag' required

Dimension to break the usage down by.

Dimension to break the usage down by.

errorsOnly'true' | 'false'

When true, scope every aggregate to failed calls only.

When true, scope every aggregate to failed calls only.

Response

Context breakdown