Update a website's backup settings

PATCH

https://api.modulards.com/api/public/v1/backup-services/:site_preset_backup

PATCH

/api/public/v1/backup-services/:site_preset_backup

curl -X PATCH https://api.modulards.com/api/public/v1/backup-services/site_preset_backup \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "content": {
    "included": [
      "database",
      "plugins",
      "themes",
      "uploads"
    ]
  },
  "filesystem": "custom",
  "status": "enabled"
}'

{
  "data": {
    "attributes": {
      "content": {
        "excluded": {
          "content": [],
          "core": [],
          "database": [],
          "files": null,
          "fonts": [],
          "mu_plugins": [],
          "plugins": [],
          "themes": [],
          "uploads": []
        },
        "included": [
          "database",
          "plugins",
          "themes",
          "uploads"
        ]
      },
      "created_at": "2026-09-01T08:30:00.000000Z",
      "filesystem": "custom",
      "last_request": "2026-09-17T01:00:00.000000Z",
      "next_request": "2026-09-18T01:00:00.000000Z",
      "schedule": {
        "day_month": null,
        "day_week": null,
        "frequency": "daily",
        "start_hour": "03:00",
        "timezone": "Europe/Madrid"
      },
      "status": "enabled",
      "updated_at": "2026-09-17T10:20:31.000000Z"
    },
    "id": "845",
    "links": {
      "self": "https://api.modulards.com/api/public/v1/backup-services/845"
    },
    "type": "site-preset-backups"
  },
  "jsonapi": {
    "version": "1.1"
  }
}

Changes how one website is backed up. Send only the fields you want to change, and at least one.

Changing the areas keeps the exclusions the website has. Changing filesystem resets them to the defaults of the new mode, and the areas too unless you send them, because the exclusions of one mode do not apply to the other.

Body

status (enabled or disabled, optional): turns the website’s automatic backups on or pauses them.
preset (integer, optional): id of another backup global configuration to move the website to. The website keeps its status, and the backups it already holds take the new configuration’s retention.
filesystem (default or custom, optional): which areas are copied. default copies the WordPress files and the database as two areas and accepts core and database; custom lets you choose among database, core, plugins, themes, mu_plugins, content and uploads.
content.included (array of strings, optional): the areas to copy; it must be sent together with filesystem.

Errors

422: no field is sent, or content.excluded (exclusions are managed in the dashboard) or schedule (the schedule belongs to the global configuration) is sent.

Authentication

AuthorizationBearer

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

Path parameters

site_preset_backupstringRequired

Query parameters

includestringOptional

Relations to add to the answer: preset (the global configuration the website uses) and last_backup (its last backup), comma separated. None by default. Any other name, including the camelCase lastBackup, answers 400.

Request

This endpoint expects an object.

contentobjectOptional

filesystemstringOptional

statusstringOptional

Response

200 - Backup service updated

dataobjectOptional

jsonapiobjectOptional

Errors

400

Bad Request Error