---
title: "delete workergroup"
method: DELETE
path: "/api/v0/workergroups/{id}/"
tags: ["Serverless"]
---

# delete workergroup

`DELETE /api/v0/workergroups/{id}/`

Deletes an existing workergroup.

CLI Usage: `vastai delete workergroup <id>`

## Path parameters

- `id` integer, required

## Response `200`

Workergroup deleted successfully

- object
  - `success` boolean
  - `deleted_workers` integer[] — List of worker instances that were deleted
  - `failed_workers` integer[] — List of worker instances that failed to delete
  - `msg` string — Additional information about the deletion

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Workergroup not found
- `429` — Too Many Requests

---

[API](https://skmtc.net/vast/apis/vast-ai-api.md) · [All operations](https://skmtc.net/vast/apis/vast-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vast/vast-ai-api/versions/4ed14f79f796/schema)