---
title: "Unregister multiple clients"
method: POST
path: "/api/v1beta/clients/unregister"
tags: ["clients"]
---

# Unregister multiple clients

`POST /api/v1beta/clients/unregister`

Unregister multiple clients from ToolHive

## Request body

- union
  - object
  - PkgApiV1BulkClientRequest
    - `groups` string[] — Groups is the list of groups configured on the client.
    - `names` GithubComStacklokToolhivePkgClientClientApp[] — Names is the list of client names to operate on.

## Response `204`

No Content

## Other responses

- `400` — Invalid request or unsupported client type

## Changes

- **2026-07-07** `3a7d8d5f17b3` — 4 breaking
  - removed the enum value `amp-cursor` of the request property `oneOf[#/components/schemas/pkg_api_v1.bulkClientRequest]/names/items/`
  - removed the enum value `amp-vscode` of the request property `oneOf[#/components/schemas/pkg_api_v1.bulkClientRequest]/names/items/`
  - removed the enum value `amp-vscode-insider` of the request property `oneOf[#/components/schemas/pkg_api_v1.bulkClientRequest]/names/items/`
  - removed the enum value `amp-windsurf` of the request property `oneOf[#/components/schemas/pkg_api_v1.bulkClientRequest]/names/items/`
- **2026-05-19** `31ce1ba030ea` — 1 info
  - added the new `copilot-cli` enum value to the request property `oneOf[#/components/schemas/pkg_api_v1.bulkClientRequest]/names/items/`
- **2026-04-30** `aaadea1b124e` — 1 breaking
  - removed the enum value `xcode` of the request property `oneOf[#/components/schemas/pkg_api_v1.bulkClientRequest]/names/items/`
- **2026-04-28** `62f5454e2ce1` — 1 info
  - added the new `xcode` enum value to the request property `oneOf[#/components/schemas/pkg_api_v1.bulkClientRequest]/names/items/`
- **2026-04-14** `ca11af4c8248` — 2 info
  - added the new `factory` enum value to the request property `oneOf[#/components/schemas/pkg_api_v1.bulkClientRequest]/names/items/`
  - added the new `kimi-cli` enum value to the request property `oneOf[#/components/schemas/pkg_api_v1.bulkClientRequest]/names/items/`

[Full history](https://skmtc.dev/stacklok/apis/toolhive-api/changes/api/v1beta/clients/unregister/post.md)

---

[API](https://skmtc.dev/stacklok/apis/toolhive-api.md) · [All operations](https://skmtc.dev/stacklok/apis/toolhive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stacklok/toolhive-api/revisions/3db2b10a01f6/schema)