Archive filenames are timestamps and hashes. Six weeks later, choosing between three of them is guesswork.
all-in-one/set-backup-label attaches a reason — “before the price change”, “before the theme swap” — turning a list of dates into a list of decisions.
At a glance
| Ability | all-in-one/set-backup-label |
| 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 | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
This ability exists only in this suite. UpdraftPlus stores no label against a backup, so there is no equivalent for it; the closest thing there is the label passed when a backup is started.
Pass an empty string to remove a label rather than looking for a delete operation.
The write is idempotent — setting the same label twice leaves the same archive, so a retry is safe.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
id | string | Yes | Archive filename from all-in-one/list-backups. |
label | string | Yes | The label. Pass an empty string to remove it. |
What comes back
| Name | Type | What it is |
|---|---|---|
backup_id | string | The archive that was labelled. |
label | string | The label as stored. |
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:
Label yesterday’s archive “before the WooCommerce upgrade”.
It resolves to one call:
{
"ability": "all-in-one/set-backup-label",
"parameters": {
"id": "acrossai-co-20260923-090000-def456.wpress",
"label": "Before the WooCommerce upgrade"
}
}Worth knowing
- Idempotent, and an empty string clears the label.
- Labelling at export time is possible too —
all-in-one/start-exporttakes alabel. - Labels are the cheapest thing you can do to make a restore decision survivable.
Related abilities
- List Archives — see the labels in context
- Start an Export — label it as it is created
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category