---
title: "MCP/tool-call log across organizations or of one (reason required; staff-access logged)"
method: GET
path: "/api/admin/tool-calls"
tags: ["admin"]
---

# MCP/tool-call log across organizations or of one (reason required; staff-access logged)

`GET /api/admin/tool-calls`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/admin/tool-calls`
- Auth: none declared

## Query parameters

- `orgId` string
- `principalId` string
- `channel` string
- `onlyFailed` 'true' | 'false'
- `limit` integer
- `reason` string: Why (required to apply a write and to read content; recorded in the audit / staff access log).

## Response `200`

OK.

- object
  - `rows` AdminToolCallRow[], required
    - `turnId` string, required
    - `at` string, required
    - `orgId` string, nullable, required
    - `principalId` string, nullable, required
    - `channel` string, required
    - `tool` string, required
    - `server` string, nullable, required
    - `ok` boolean, required
    - `ms` number, required
    - `errorKind` string, nullable, required
    - `errorMessage` string, nullable, required
    - `resultBytes` number, nullable, required
    - `truncated` boolean, required

## Other responses

- `400`: Invalid request or reason missing.
- `403`: Not a super_admin.

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)