List site items | Modular DS | API documentation

{
  "data": [
    {
      "attributes": {
        "basename": "woocommerce/woocommerce.php",
        "can_upgrade": true,
        "component_id": 42,
        "copilot_score": 92,
        "created_at": "2026-06-01T09:00:00.000000Z",
        "has_error": false,
        "is_hidden": false,
        "name": "WooCommerce",
        "new_version": "8.10.1",
        "previous_version": null,
        "slug": "woocommerce",
        "status": "active",
        "type": "plugin",
        "updated_at": "2026-09-15T07:30:00.000000Z",
        "version": "8.10.0",
        "vulnerabilities_c_exists": false,
        "vulnerabilities_exists": false
      },
      "id": "301",
      "links": {
        "self": "{{base_url}}/api/public/v1/site-items/301"
      },
      "type": "site-items"
    },
    {
      "attributes": {
        "basename": null,
        "can_upgrade": false,
        "component_id": 7,
        "copilot_score": 100,
        "created_at": "2026-04-10T09:00:00.000000Z",
        "has_error": false,
        "is_hidden": false,
        "name": "WordPress",
        "new_version": null,
        "previous_version": "6.8.0",
        "slug": "wordpress",
        "status": "active",
        "type": "core",
        "updated_at": "2026-09-10T07:30:00.000000Z",
        "version": "6.8.1",
        "vulnerabilities_c_exists": false,
        "vulnerabilities_exists": false
      },
      "id": "302",
      "links": {
        "self": "{{base_url}}/api/public/v1/site-items/302"
      },
      "type": "site-items"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "links": {
    "first": "{{base_url}}/api/public/v1/site-items?page%5Bnumber%5D=1",
    "last": "{{base_url}}/api/public/v1/site-items?page%5Bnumber%5D=1",
    "next": null,
    "prev": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "active": false,
        "label": "&laquo; Previous",
        "url": null
      },
      {
        "active": true,
        "label": "1",
        "url": "{{base_url}}/api/public/v1/site-items?page%5Bnumber%5D=1"
      },
      {
        "active": false,
        "label": "Next &raquo;",
        "url": null
      }
    ],
    "path": "{{base_url}}/api/public/v1/site-items",
    "per_page": 15,
    "to": 2,
    "total": 2
  }
}

Every installed WordPress item across the token’s sites, organization-wide (not scoped to one site). Replaces the old single-site sites/{site}/items listing; filter[site] narrows it back to one or more sites, filter[component] answers “which sites run this component”. Default sort: name. The MCP twin is sites-items-index.

Every installed WordPress item across the token's sites, organization-wide (not scoped to one site). Replaces the old single-site `sites/{site}/items` listing; `filter[site]` narrows it back to one or more sites, `filter[component]` answers "which sites run this component". Default sort: `name`. The MCP twin is `sites-items-index`.

Authentication

AuthorizationBearer

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

Query parameters

filter[component]stringOptional

Exact component id

filter[site][]stringOptional

Site id(s)

filter[team][]stringOptional

Team id(s)

filter[tags][]stringOptional

Tag id(s)

filter[core_version][]stringOptional

Exact WordPress versions of the website, for example 6.8.1; repeat the parameter for several, any of them matches

filter[engine_version][]stringOptional

Exact PHP versions of the website, for example 8.2.27; repeat the parameter for several, any of them matches

filter[type][]stringOptional

core | plugin | theme

filter[status][]stringOptional

active | inactive | uninstalled

filter[update_available]stringOptional

1|0: true = a newer version exists

filter[updatable]stringOptional

1|0: true = a newer version exists, the update is not hidden and the site accepts installs

filter[has_vulnerabilities]stringOptional

1|0: true = at least one known vulnerability on the installed version

filter[is_hidden]stringOptional

1|0. Omitted = only visible items; 0 = only visible; 1 = only hidden

filter[s]stringOptional

Free-text search over the item name

sortstringOptional

page[number]stringOptional

page[size]stringOptional

Max 50, default 15

fields[site-items]stringOptional

Sparse fieldset; activates computed fields: copilot_score, released_at, days_since_release, in_progress_action_id/type/status, can_upgrade, can_safe_upgrade, can_activate, can_deactivate, can_delete, last_error, history

includestringOptional

Inlines the owning site

Response

200 - Site items

datalist of objectsOptional

jsonapiobjectOptional

linksobjectOptional

metaobjectOptional