Get Observability Tools
Distinct tool_name values within the requested filter scope.
Powers the FE TraceHeader tool-filter dropdown. Without this endpoint, the FE has to derive available tools from spans the user has manually expanded — most users never expanded enough sessions to see the filter populate. Returns a flat sorted list capped server-side.
Same filter precedence as /sessions (agent_id wins; else
(project_key_id, client_id); else fleet-wide). Default range is the
last 24h, matching the rollup window.
GET
/agentic/observability/toolsAuthorization
AuthorizationBearer token · headerrequiredQuery parameters
agent_idstring | anyStreamkap agent id (Mongo ObjectId or external:pk:cid)
project_key_idstring | anyExternal pseudo-agent: project_key_id
client_idstring | anyExternal pseudo-agent: client_id
fromstring | anyTime range start (ISO 8601)
tostring | anyTime range end (ISO 8601)
Responses
200
Successful Response
toolsstring[]required422
Validation Error
detailValidationError[]Show propertiesHide properties
Array of
ValidationErrorlocstring | integer[]requiredShow propertiesHide properties
Array of
string | integerAny of:
string
stringinteger
integermsgstringrequiredtypestringrequiredinputanyctxobject