all-in-one/list-backups returns the archives held on this server, newest first, with size, age and whatever label was attached to each.
The identifier it returns is the archive filename, and it is what every other ability here takes.
At a glance
| Ability | all-in-one/list-backups |
| 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 | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
An All-in-One archive is one .wpress file containing the database and the files together. There is no per-component listing because there are no separate components — which is the plugin’s great convenience and its main limitation.
Size is the number to watch. The free edition’s import limit is what stops most restores, and an archive comfortably larger than that limit is a backup you cannot use without either the paid extension or a manual route.
This reads the local store only. An archive downloaded and then deleted from the server will not appear, so an empty list does not mean no backup exists anywhere.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
limit | integer | No — defaults to 20, max 100 | How many archives to return. |
offset | integer | No — defaults to 0 | Where to start, for paging. |
What comes back
| Name | Type | What it is |
|---|---|---|
backups | array | One entry per archive: id, when it was taken, age, size and label. |
count | integer | How many archives were returned. |
total | integer | How many archives exist on this server. |
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:
Which All-in-One archives do we have, and how big are they?
It resolves to one call:
{
"ability": "all-in-one/list-backups",
"parameters": {
"limit": 10
}
}Worth knowing
- Check the size against the import limit before planning to restore from one.
- Labels make a list of timestamps readable —
all-in-one/set-backup-labelattaches them, and only this plugin supports them. - The id is the archive filename. Pass it through unchanged.
Related abilities
- Get an Archive — one archive in full
- Label an Archive — make the list readable
- Delete an Archive — free the space
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category