Update backup service | Modular DS

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": null,
          "core": null,
          "database": null,
          "files": null,
          "fonts": null,
          "mu_plugins": null,
          "plugins": null,
          "themes": null,
          "uploads": null
        },
        "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",
    "type": "site-preset-backups"
  },
  "jsonapi": {
    "version": "1.1"
  }
}

Changes how ONE website is backed up. Send only what changes (at least one field); answers 200 with the backup service document, its attributes reading back under the same keys this body accepts.

Body (JSON), every field optional:

status (enabled, disabled) - enables or pauses the website’s automatic copies.
preset (integer) - id of another backup global configuration to move the website to. The website keeps its status, and the copies it already holds take the new configuration’s retention.
filesystem (default, custom) and content.included (array) - what is copied. content.included must be sent together with filesystem: default accepts core and database; custom accepts database, core, plugins, themes, mu_plugins, content and uploads.

Changing the areas keeps the exclusions the website has. Changing the 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.

Exclusions are managed in the dashboard: sending content.excluded answers 422. The schedule belongs to the configuration: sending schedule answers 422.

Requires a full-access token (read-only tokens answer 403). A backup service or a configuration of another organization answers 404.

Changes how ONE website is backed up. Send only what changes (at least one field); answers **200** with the backup service document, its attributes reading back under the same keys this body accepts. **Body** (JSON), every field optional: - `status` (`enabled`, `disabled`) - enables or pauses the website's automatic copies. - `preset` (integer) - id of another backup global configuration to move the website to. The website keeps its status, and the copies it already holds take the new configuration's retention. - `filesystem` (`default`, `custom`) and `content.included` (array) - what is copied. `content.included` must be sent together with `filesystem`: `default` accepts `core` and `database`; `custom` accepts `database`, `core`, `plugins`, `themes`, `mu_plugins`, `content` and `uploads`. Changing the areas keeps the exclusions the website has. Changing the `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. Exclusions are managed in the dashboard: sending `content.excluded` answers 422. The schedule belongs to the configuration: sending `schedule` answers 422. Requires a full-access token (read-only tokens answer 403). A backup service or a configuration of another organization answers 404.

Authentication

AuthorizationBearer

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

Path parameters

site_preset_backupstringRequired

Request

This endpoint expects an object.

contentobjectOptional

filesystemstringOptional

statusstringOptional

Response

200 - Backup service updated

dataobjectOptional

jsonapiobjectOptional

Changes how ONE website is backed up. Send only what changes (at least one field); answers 200 with the backup service document, its attributes reading back under the same keys this body accepts.

Body (JSON), every field optional:

status (enabled, disabled) - enables or pauses the website’s automatic copies.
preset (integer) - id of another backup global configuration to move the website to. The website keeps its status, and the copies it already holds take the new configuration’s retention.
filesystem (default, custom) and content.included (array) - what is copied. content.included must be sent together with filesystem: default accepts core and database; custom accepts database, core, plugins, themes, mu_plugins, content and uploads.

Exclusions are managed in the dashboard: sending content.excluded answers 422. The schedule belongs to the configuration: sending schedule answers 422.

Requires a full-access token (read-only tokens answer 403). A backup service or a configuration of another organization answers 404.