Sync site items

POST

https://api.modulards.com/api/public/v1/site-items/sync

POST

/api/public/v1/site-items/sync

curl -X POST https://api.modulards.com/api/public/v1/site-items/sync \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "sites": [
    12,
    13
  ]
}'

202Sync site items

{
  "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 website is not connected; connect it first.",
        "reason_code": "SITE_UNREACHABLE",
        "site_action_id": null,
        "site_id": 13,
        "site_name": "Blog"
      }
    ]
  }
}

Asks the websites you list in sites to report again which plugins, themes and WordPress version they have installed, and updates Modular DS with the answer. Use it after you changed a website directly in WordPress.

It creates one site action per website that passes the checks. The work finishes later: see Writes and asynchronous operations. Follow the site actions with “List site actions”. Websites that cannot be processed are reported in meta.skipped, each with a reason_code and a message, and do not fail the call. A website is skipped when it is not connected (SITE_UNREACHABLE), when its inventory was synchronized recently (ALREADY_APPLIED), when it already has too many pending or running actions (CONFLICT), or when you have no access to it (PERMISSION_DENIED).

Body

sites (array of integers, required): ids of the websites to act on, 1 to 50.

Errors

422: sites is missing, empty, has more than 50 ids, or contains an id that matches no website.

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