Site backups summary

View as MarkdownOpen in Claude
One row per website the token can reach, as a paginated JSON:API collection of type `site-backup-summaries` whose id is the website's id: `site` (`{id, name}`), `last_backup` (`{id, phase, status, created_at}` of the newest copy whatever its phase, or `null` when the website has none), `last_done_at` (when the last usable copy was taken), `storage_used` (bytes) and `total_count`. Answers "which websites have no recent backup" in one call; the copies behind a row are listed by `GET /site-backups` with `filter[site][]`. The rows are websites, so the website filters of `GET /sites` apply (`filter[id][]`, `filter[team][]`, `filter[tags][]`, `filter[connected]`, `filter[s]`, `filter[core_version][]`, `filter[engine_version][]`) and the order is the websites' default order. `sort`, `include` and `fields` are prohibited here and answer 422. A read-only token is enough; a member without the backups read permission answers 404. The MCP twin is the `site-backups-summary` tool.

Authentication

AuthorizationBearer

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

Query parameters

filter[id][]stringOptional

Exact website ids (repeatable)

filter[team][]stringOptional

Team ids (repeatable)

filter[tags][]stringOptional

Tag ids (repeatable)

filter[connected]stringOptional

1|0 - only connected or only disconnected websites

filter[s]stringOptional

Free-text search on the website name or address

filter[core_version][]stringOptional

Exact WordPress versions of the website, for example 6.8.1; repeat the parameter for several, any of them matches

filter[engine_version][]stringOptional

Exact PHP versions of the website, for example 8.2.27; repeat the parameter for several, any of them matches

page[number]stringOptional
page[size]stringOptional
Max 50

Response