---
title: "Tools whose calls ToolPiper is still handling for the caller"
method: GET
path: "/v1/tool-approvals/held"
tags: ["Tools"]
---

# Tools whose calls ToolPiper is still handling for the caller

`GET /v1/tool-approvals/held`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/tool-approvals/held`
- Auth: HTTP bearer

The tools whose calls by the caller's client ToolPiper is still handling, from
the moment a call is judged until it completes: waiting on a person's answer on
the Mac (the review card, owner authentication, the folder picker, a consent a
running call raised) or running. A caller whose mirrored call is past its own
deadline keeps waiting while its request is listed, and treats the call as
stalled otherwise. Names only the caller's own calls, and only their tools and
requests. An older build answers 404.

## Response `200`

The caller's held tools, sorted, each once

- ToolApprovalsHeldResponse
  - `tools` string[], required: The tools of the calls ToolPiper is still handling, sorted, each once.
  - `requests` string[], required: The REST requests those calls came from, as `METHOD /path` (the path as sent, without its query), sorted, each once.

## Other responses

- `403`: The caller is not an authenticated client

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)