---
title: "Unregister a session's client tool catalog"
method: POST
path: "/v1/tools/unregister-client-catalog"
tags: ["Tools"]
---

# Unregister a session's client tool catalog

`POST /v1/tools/unregister-client-catalog`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/tools/unregister-client-catalog`
- Auth: HTTP bearer

Removes all client tools previously registered for `session_id` and
rebuilds the unified embedding index without them. Idempotent — a
session that was never registered returns 200.

## Request body

- object
  - `session_id` string, required: Session identifier whose client catalog should be removed.

## Response `200`

Catalog unregistered

- object
  - `status` 'unregistered', required

## Other responses

- `400`: Invalid request
- `500`: Index rebuild failed
- `503`: ToolGate service not available

---

[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)