Uninstall component | Modular DS

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

{
  "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.delete",
        "updated_at": "2026-09-21T09:00:00.000000Z"
      },
      "id": "5013",
      "links": {
        "self": "{{base_url}}/api/public/v1/site-actions/5013"
      },
      "type": "site-actions"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "meta": {
    "skipped": [
      {
        "message": "Deactivate this item on this website before deleting it.",
        "reason_code": "UNSUPPORTED",
        "site_action_id": null,
        "site_id": 13,
        "site_name": "Blog"
      }
    ]
  }
}

Body parameters:

sites (integer array, required): exact ids, 1 to 200.
confirm_token (string, nullable): ignored on this surface; present only because the request is shared with the MCP tool.

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} (an active item answers reason_code: UNSUPPORTED; a disconnected website SITE_UNREACHABLE). site_action_id is always null in these entries; site_name is null for PERMISSION_DENIED. data: [] is still a 202.

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

Deletes one plugin or theme from the selection. Only inactive items are eligible; deactivate first with the manage request. This surface executes directly: no two-phase confirmation, unlike the MCP `components-uninstall` tool sharing this same request body; `confirm_token`, if sent, is accepted and ignored. Body parameters: - `sites` (integer array, required): exact ids, 1 to 200. - `confirm_token` (string, nullable): ignored on this surface; present only because the request is shared with the MCP tool. 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}` (an active item answers `reason_code: UNSUPPORTED`; a disconnected website `SITE_UNREACHABLE`). `site_action_id` is always null in these entries; `site_name` is null for `PERMISSION_DENIED`. `data: []` is still a 202. - **422**: `sites` missing/empty/over 200/unknown id. - **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.

siteslist of doublesOptional

Response

202 Accepted - one uninstall launched, one website skipped

datalist of objectsOptional

jsonapiobjectOptional

metaobjectOptional

Body parameters:

sites (integer array, required): exact ids, 1 to 200.
confirm_token (string, nullable): ignored on this surface; present only because the request is shared with the MCP tool.

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