all-in-one/delete-backup removes one archive from this server and reports how much disk space that recovered.
All-in-One archives are large and they accumulate, so this is an ability people reach for under disk pressure — which is exactly when it is easiest to delete the wrong one.
Before you run it
This cannot be undone, and what it destroys is a recovery point. The call refuses without confirm: true. Copies held on remote storage are not removed — delete those in the storage provider itself if reclaiming that space was the point.
At a glance
| Ability | all-in-one/delete-backup |
| Toolset | All-in-One WP Migration — toolset/all-in-one-wp-migration |
| Group | All-in-One WP Migration › Archives |
| Requires | All-in-One WP Migration, active on the site |
| Capability | manage_options |
| Safety | Destructive — deletes stored values, and refuses to run without confirm: true |
| Repeatable | Not idempotent — each call changes the row set, so re-running is not a no-op |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
The confirmation gate runs before any file is touched, so a refused call leaves the archive intact.
Check the labels first. On this plugin more than most, the archive worth keeping is rarely the newest one — it is the one taken deliberately before a risky change.
The response reports the files removed, the bytes freed and how many archives remain, so the cost of the deletion sits next to its benefit.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
id | string | Yes | Archive identifier, exactly as returned by all-in-one/list-backups. |
confirm | boolean | Yes — must be true | The irreversibility gate. Without it the call is refused before anything is touched. |
What comes back
| Name | Type | What it is |
|---|---|---|
backup_id | string | The archive that was deleted. |
files_removed | array | The files that were removed. |
bytes_freed | integer | How much disk space that recovered. |
remaining | integer | How many archives are left on this server. |
note | string | Anything else worth knowing. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Delete the unlabelled archive from July — we’re out of disk space.
It resolves to one call:
{
"ability": "all-in-one/delete-backup",
"parameters": {
"id": "acrossai-co-20260714-030000-ghi789.wpress",
"confirm": true
}
}Worth knowing
- Not idempotent, and not reversible.
- Remote copies survive. If the goal was removing the data rather than freeing disk, this did not achieve it.
- Read the labels before choosing.
all-in-one/list-backupsshows them.
Related abilities
- List Archives — confirm which one you mean
- Get an Archive — check its size and age first
- All-in-One Backup Status — what recovery looks like afterwards
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category