---
title: "Tool use for one workspace"
method: GET
path: "/v1/admin/tenants/{tenant_id}/tool-usage"
tags: ["admin"]
---

# Tool use for one workspace

`GET /v1/admin/tenants/{tenant_id}/tool-usage`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/admin/tenants/{tenant_id}/tool-usage`
- Auth: HTTP bearer

Tool calls in one workspace in a time window of at most 93 days, one entry per tool name, ordered by total output size. Each entry has the call, run and error counts, total and largest output bytes, total input bytes and mean duration in milliseconds. No tool input or output text is returned.

## Path parameters

- `tenant_id` string, uuid, required: The workspace id.

## Query parameters

- `created_after` string, date-time, required: Start of the window, an ISO 8601 date-time.
- `created_before` string, date-time: End of the window, an ISO 8601 date-time. Defaults to now. At most 93 days after `created_after`.
- `tool_limit` integer: How many tools to return, 1 to 50. Defaults to 15.

## Response `200`

Successful Response

- ToolUsage
  - `tools` ToolUsageEntry[], required
    - `tool_name` string, required
    - `call_count` integer, required
    - `run_count` integer, required
    - `error_count` integer, required
    - `total_output_bytes` integer, required
    - `max_output_bytes` integer, required
    - `total_input_bytes` integer, required
    - `mean_duration_ms` number, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)