Manage component

PATCH

https://api.modulards.com/api/public/v1/components/:component/manage

PATCH

/api/public/v1/components/:component/manage

curl -X PATCH https://api.modulards.com/api/public/v1/components/component/manage \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "action": "deactivate",
  "sites": [
    12
  ]
}'

202Manage component

{
  "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.deactivate",
        "updated_at": "2026-09-21T09:00:00.000000Z"
      },
      "id": "5012",
      "links": {
        "self": "{{base_url}}/api/public/v1/site-actions/5012"
      },
      "type": "site-actions"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "meta": {
    "skipped": [
      {
        "message": "This site is not connected; connect it before managing this component.",
        "reason_code": "SITE_UNREACHABLE",
        "site_action_id": null,
        "site_id": 13,
        "site_name": "Blog"
      }
    ]
  }
}

Activates or deactivates one plugin or theme on the selection. The action is explicit, never a flip: one manager.activate/manager.deactivate Site Action per accepted website.

Body parameters:

sites (integer array, required): exact ids, 1 to 200.
action (string, required): activate | deactivate.

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. data: [] is still a 202.

422: sites missing/empty/over 200/unknown id; action outside activate/deactivate.
404: {component} does not exist or is not reachable from the token’s organization.
403: a read-only token.

Activates or deactivates one plugin or theme on the selection. The action is explicit, never a flip: one `manager.activate`/`manager.deactivate` Site Action per accepted website. Body parameters: - `sites` (integer array, required): exact ids, 1 to 200. - `action` (string, required): `activate` | `deactivate`. 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`. `data: []` is still a 202. - **422**: `sites` missing/empty/over 200/unknown id; `action` outside `activate`/`deactivate`. - **404**: `{component}` does not exist or is not reachable from the token's organization. - **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

componentstringRequired

Request

This endpoint expects an object.

actionstringOptional

siteslist of doublesOptional

Response

202 Accepted - one deactivation launched, one website skipped

datalist of objectsOptional

jsonapiobjectOptional

metaobjectOptional