MagicWP Docs
Updates

Update items across sites

POST
/v1/updates/apply

Permission: wp.updates on each site named

Authorization

apiToken
headerAuthorizationBearer <token>

An API token (mwp_…) from Settings → API tokens. Only accepted on this host.

Header Parameters

Idempotency-Key?string

Any unique string up to 255 characters. Retrying with the same key returns the first request's stored response (header Idempotent-Replayed: true) instead of doing it again, for 24 hours. The same key with a different request is refused (idempotency_key_reused).

Length1 <= length <= 255

Request Body

application/json
  1. body

Either specific items, or a scope.

scope is what the "update all plugins" / "update everything" buttons send; items is what a single row's button sends.

site_ids?array<>|null
items?array<>|null
scope?|null

Response Body

Successful Response

application/json
  1. response
success*boolean
data*

The same action on several sites: one task per site.

message*string
status_code*integer
timestamp*string
Formatdate-time
meta?|null
curl -X POST "https://example.com/v1/updates/apply" \  -H "Content-Type: application/json" \  -d '{}'
{  "message": "string",  "status_code": 0,  "timestamp": "2019-08-24T14:15:22Z",  "meta": {},  "success": true,  "data": {    "tasks": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "task_type": "string",        "site_id": "72771e6a-6f5e-4de4-a5b9-1266c4197811",        "status": "string",        "result": "string",        "error_message": "string",        "metadata_json": {},        "created_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z",        "completed_at": "2019-08-24T14:15:22Z"      }    ]  }}