Delete site backups | Modular DS

Deletes backups permanently. A copy still uploading is cancelled on the website first (best effort); master backups are deleted like any other copy. Nothing restores a deleted copy.

Body parameters:

backups (integer array, required): exact backup ids, 1 to 50.

Answers 204 with no body.

404: any id the token cannot reach (another organization, outside the member’s websites) refuses the whole call and nothing is deleted; also a member without the delete permission.
422: backups missing, empty, over 50 ids, or containing an id that resolves to no row.
403: a read-only token.

The MCP twin is the site-backups-destroy tool, which asks the user for confirmation in two phases; this endpoint executes at once.

Deletes backups permanently. A copy still uploading is cancelled on the website first (best effort); master backups are deleted like any other copy. Nothing restores a deleted copy. Body parameters: - `backups` (integer array, required): exact backup ids, 1 to 50. Answers **204** with no body. - **404**: any id the token cannot reach (another organization, outside the member's websites) refuses the whole call and nothing is deleted; also a member without the delete permission. - **422**: `backups` missing, empty, over 50 ids, or containing an id that resolves to no row. - **403**: a read-only token. The MCP twin is the `site-backups-destroy` tool, which asks the user for confirmation in two phases; this endpoint executes at once.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Request

This endpoint expects an object.

backupslist of doublesOptional

Response

204 No Content

Deletes backups permanently. A copy still uploading is cancelled on the website first (best effort); master backups are deleted like any other copy. Nothing restores a deleted copy.

Body parameters:

backups (integer array, required): exact backup ids, 1 to 50.

Answers 204 with no body.

404: any id the token cannot reach (another organization, outside the member’s websites) refuses the whole call and nothing is deleted; also a member without the delete permission.
422: backups missing, empty, over 50 ids, or containing an id that resolves to no row.
403: a read-only token.

The MCP twin is the site-backups-destroy tool, which asks the user for confirmation in two phases; this endpoint executes at once.