---
title: "Batch stop CVMs"
method: POST
path: "/api/v1/cvms/batch-stop"
tags: ["CVMs"]
---

# Batch stop CVMs

`POST /api/v1/cvms/batch-stop`

Force stop multiple CVMs at once. Non-admin users can only stop CVMs in their current workspace. Admin users can stop any CVM. Max 50 per request.

## Request body

- BatchStopRequest — Request to batch stop multiple CVMs.
  - `cvm_ids` string[], required — List of CVM hash IDs to stop

## Response `200`

Batch stop summary

- BatchStopResponse — Summary of batch stop operation.
  - `total` integer, required — Total CVMs requested
  - `stopped` integer, required — CVMs successfully scheduled for stop
  - `skipped` integer, required — CVMs skipped (in_progress, no vm_uuid, GPU rental managed)
  - `errors` BatchStopErrorEntry[] — CVMs that failed to stop
    - `cvm_id` string, required — Hashed CVM ID
    - `error` string, required — Error message

## Other responses

- `400` — Invalid request (e.g. too many CVMs)
- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/phala/apis/phala-cloud-api.md) · [All operations](https://skmtc.net/phala/apis/phala-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phala/phala-cloud-api/versions/83c6ae62e860/schema)