---
title: "Remove multiple environments"
method: DELETE
path: "/endpoints"
tags: ["endpoints"]
deprecated: true
---

# Remove multiple environments

`DELETE /endpoints`

> **Deprecated.**

Deprecated: use the `POST` endpoint instead.
Remove multiple environments and optionally clean-up associated resources.
**Access policy**: Administrator only.

## Request body

- EndpointsEndpointDeleteBatchPayload
  - `endpoints` EndpointsEndpointDeleteRequest[]
    - `deleteCluster` boolean
    - `id` integer

## Response `204`

Environment(s) successfully deleted.

## Other responses

- `207` — Partial success. Some environments were deleted successfully, while others failed.
- `400` — Invalid request payload, such as missing required fields or fields not meeting validation criteria.
- `403` — Unauthorized access or operation not allowed.
- `500` — Server error occurred while attempting to delete the specified environments.

---

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