Validate site action

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"
}'

200Validate site action

{
  "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"
  }
}

The human verdict on a safe upgrade waiting in REQUIRES_ACTION.\n\nBody parameters:\n- action (string, required): approve | rollback.\n\n200 with the action after the decision, with its detail fields, so the client sees the validation step closed.\n\n- 422: action missing or outside approve/rollback.\n- 404: the action does not exist, is not reachable from the token’s organization, or is not currently requires_action (the policy denies as not found in that case).\n- 403: a read-only token.

The human verdict on a safe upgrade waiting in `REQUIRES_ACTION`.\n\nBody parameters:\n- `action` (string, required): `approve` | `rollback`.\n\n200 with the action after the decision, with its detail fields, so the client sees the validation step closed.\n\n- **422**: `action` missing or outside `approve`/`rollback`.\n- **404**: the action does not exist, is not reachable from the token's organization, or is not currently `requires_action` (the policy denies as not found in that case).\n- **403**: a read-only token.

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