Sync site items | Modular DS | API documentation

{
  "data": [
    {
      "attributes": {
        "completed_at": null,
        "created_at": "2026-09-21T09:00:00.000000Z",
        "created_by": 501,
        "origin": "agent",
        "site_id": 12,
        "started_at": null,
        "status": "pending",
        "type": "manager.update",
        "updated_at": "2026-09-21T09:00:00.000000Z"
      },
      "id": "5001",
      "links": {
        "self": "{{base_url}}/api/public/v1/site-actions/5001"
      },
      "type": "site-actions"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "meta": {
    "skipped": [
      {
        "message": "This site is not connected; connect it before syncing its items.",
        "reason_code": "SITE_UNREACHABLE",
        "site_action_id": null,
        "site_id": 13,
        "site_name": "Blog"
      }
    ]
  }
}

Refreshes the inventory of installed plugins, themes and core on the selection: one site-items.sync Site Action per website the preflight accepted.

Body parameters:

sites (integer array, required): exact website ids, 1 to 200, scoped to the token’s organization.

202 with the created site-actions documents under data and meta.skipped: one entry per website the preflight refused, {site_id, site_name, site_action_id, reason_code, message}. site_action_id is always null in these entries; site_name is null for PERMISSION_DENIED. A disconnected website answers reason_code: SITE_UNREACHABLE; a website synchronized recently ALREADY_APPLIED. data: [] is still a 202.

422: sites missing, empty, over 200 ids, or containing an id that resolves to no row.
403: a read-only token (read ability only, no write).

Refreshes the inventory of installed plugins, themes and core on the selection: one `site-items.sync` Site Action per website the preflight accepted. Body parameters: - `sites` (integer array, required): exact website ids, 1 to 200, scoped to the token's organization. 202 with the created `site-actions` documents under `data` and `meta.skipped`: one entry per website the preflight refused, `{site_id, site_name, site_action_id, reason_code, message}`. `site_action_id` is always null in these entries; `site_name` is null for `PERMISSION_DENIED`. A disconnected website answers `reason_code: SITE_UNREACHABLE`; a website synchronized recently `ALREADY_APPLIED`. `data: []` is still a 202. - **422**: `sites` missing, empty, over 200 ids, or containing an id that resolves to no row. - **403**: a read-only token (`read` ability only, no `write`).

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

siteslist of doublesOptional

Response

202 Accepted - one sync launched, one website skipped

datalist of objectsOptional

jsonapiobjectOptional

metaobjectOptional

Refreshes the inventory of installed plugins, themes and core on the selection: one site-items.sync Site Action per website the preflight accepted.

Body parameters:

sites (integer array, required): exact website ids, 1 to 200, scoped to the token’s organization.

422: sites missing, empty, over 200 ids, or containing an id that resolves to no row.
403: a read-only token (read ability only, no write).