A backup runs in the background, so starting one and knowing one finished are two different facts.
updraftplus/get-backup-progress supplies the second. Give it the job_id from updraftplus/start-backup and it reports whether the job is still going, whether it finished, and which set it produced.
At a glance
| Ability | updraftplus/get-backup-progress |
| Toolset | UpdraftPlus — toolset/updraftplus |
| Group | UpdraftPlus › Taking backups |
| Requires | UpdraftPlus, 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
running and finished are separate flags rather than one state, because a job can be neither: queued but not yet advanced, which on a low-traffic site is a normal condition rather than a fault. WordPress cron needs a request to move.
backup_id is null until there is a set. Once it is populated, that id works everywhere else in this group.
last_message is the plugin’s own progress text. On a stalled job it is usually the fastest explanation of where it stopped.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
job_id | string | Yes | Job identifier returned by updraftplus/start-backup. |
What comes back
| Name | Type | What it is |
|---|---|---|
job_id | string | The job being reported on. |
running | boolean | Whether it is actively working. |
finished | boolean | Whether it completed. |
backup_id | string or null | The set it produced, once there is one. |
last_message | string | The plugin’s own progress text. |
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:
Is that backup finished yet?
It resolves to one call:
{
"ability": "updraftplus/get-backup-progress",
"parameters": {
"job_id": "a1b2c3d4e5f6"
}
}Worth knowing
- Neither running nor finished usually means cron has not fired. A page view on the site is often enough.
- Do not start the risky work until
finishedis true andbackup_idis populated. - Read-only, so polling it costs nothing.
Related abilities
- Start Backup — where the job_id comes from
- Get Backup — inspect the set it produced
- Get Backup Status — whether a backup is running at all
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category