---
title: "Get Observability Tools"
method: GET
path: "/agentic/observability/tools"
tags: ["Agents Observability"]
---

# Get Observability Tools

`GET /agentic/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.

## Query parameters

- `agent_id` string, nullable — Streamkap agent id (Mongo ObjectId or external:pk:cid)
- `project_key_id` string, nullable — External pseudo-agent: project_key_id
- `client_id` string, nullable — External pseudo-agent: client_id
- `from` string, nullable — Time range start (ISO 8601)
- `to` string, nullable — Time range end (ISO 8601)

## Response `200`

Successful Response

- ObservabilityToolsResponse — `/agentic/observability/tools` response. Distinct ``tool_name`` values within the requested filter scope. Powers the FE TraceHeader tool-filter dropdown so it populates eagerly without requiring the user to expand session spans first. Empty list is a legitimate result (scope had no tool calls in the window) and the FE hides the dropdown in that case.
  - `tools` string[], required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)