Approve or roll back a safe update

POST

https://api.modulards.com/api/public/v1/site-actions/:siteAction/validate

POST

/api/public/v1/site-actions/:siteAction/validate

curl -X POST https://api.modulards.com/api/public/v1/site-actions/siteAction/validate \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "action": "approve"
}'

200Approve or roll back a safe update

{
  "data": {
    "attributes": {
      "clean_cache": true,
      "completed_at": null,
      "created_at": "2026-09-20T09:00:00.000000Z",
      "created_by": 501,
      "is_manual": false,
      "managed_items": [
        {
          "from_version": "8.9.5",
          "name": "WooCommerce",
          "site_item_id": 301,
          "slug": "woocommerce",
          "to_version": "8.10.0",
          "type": "plugin"
        }
      ],
      "origin": "agent",
      "requires_action": false,
      "scheduled_at": null,
      "site_id": 12,
      "started_at": "2026-09-20T09:00:00.000000Z",
      "status": "in_progress",
      "target_site": {
        "id": 12,
        "slug": "shop",
        "url": "https://shop.example.com"
      },
      "type": "manager.safe_upgrade",
      "updated_at": "2026-09-20T09:12:00.000000Z",
      "visual_regression": {
        "change_percentage": 1.2,
        "screenshots": {
          "after": "https://cdn.modulards.com/safe-upgrade/504/after.png?signature=abc",
          "before": "https://cdn.modulards.com/safe-upgrade/504/before.png?signature=abc",
          "diff": "https://cdn.modulards.com/safe-upgrade/504/diff.png?signature=abc"
        },
        "success_path": "/",
        "threshold": 5
      }
    },
    "id": "504",
    "links": {
      "self": "{{base_url}}/api/public/v1/site-actions/504"
    },
    "type": "site-actions"
  },
  "jsonapi": {
    "version": "1.1"
  }
}

Gives your verdict on a safe update that is waiting for your decision (status requires_action): approve it to keep the update, or roll it back to restore the website as it was. A safe update that nobody decides within 7 days of starting to wait is approved automatically. Returns the site action after the decision, with its details.

Body

action (approve or rollback, required): your verdict.

Errors

404: the site action does not exist, is not one of your organization’s, or is not waiting for a decision.
422: action is missing or is not approve or rollback.

Authentication

AuthorizationBearer

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

Path parameters

siteActionstringRequired

Request

This endpoint expects an object.

actionstringOptional

Response

200 - Safe upgrade approved

dataobjectOptional

jsonapiobjectOptional