v3

latestOpenAPI 3.1.0Proprietary2026-08-07266348629.6 KB
Agents Observability

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/tools

Query parameters

agent_idstring nullable

Streamkap agent id (Mongo ObjectId or external:pk:cid)

Streamkap agent id (Mongo ObjectId or external:pk:cid)

project_key_idstring nullable

External pseudo-agent: project_key_id

External pseudo-agent: project_key_id

client_idstring nullable

External pseudo-agent: client_id

External pseudo-agent: client_id

fromstring nullable

Time range start (ISO 8601)

Time range start (ISO 8601)

tostring nullable

Time range end (ISO 8601)

Time range end (ISO 8601)

Response

Successful Response

toolsstring[] required