Update site tags | Modular DS | API documentation

curl -X PATCH https://api.modulards.com/api/public/v1/sites/site/tags \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "add_tags": [
    1,
    2
  ],
  "remove_tags": [
    3
  ]
}'

{
  "data": {
    "attributes": {
      "connection_status": "established",
      "connector_version": "3.4.2",
      "core_version": "6.6.2",
      "created_at": "2026-01-14T09:30:00.000000Z",
      "created_by": 42,
      "db_engine": "mysql",
      "db_engine_version": "8.0.36",
      "deleted_at": null,
      "display_host": "acme-corp.com",
      "ecommerce_engine": "woocommerce",
      "ecommerce_version": "9.2.3",
      "engine": "php",
      "engine_version": "8.3.10",
      "host": "acme-corp.com",
      "is_connected": true,
      "is_main_site": true,
      "is_multisite": false,
      "locale": "en_US",
      "name": "Acme Corp",
      "path": null,
      "provider": "wp",
      "scheme": "https",
      "slug": "acme-corp",
      "synced_at": "2026-09-16T08:12:00.000000Z",
      "timezone": "Europe/Madrid",
      "updated_at": "2026-09-21T09:50:00.000000Z",
      "uri": "https://acme-corp.com"
    },
    "id": "101",
    "links": {
      "self": "https://api.modulards.com/api/public/v1/sites/101"
    },
    "relationships": {
      "tags": {
        "data": [
          {
            "id": "1",
            "type": "tags"
          },
          {
            "id": "2",
            "type": "tags"
          }
        ]
      }
    },
    "type": "sites"
  },
  "included": [
    {
      "attributes": {
        "color": "#FF5733",
        "created_at": "2026-01-20T10:00:00.000000Z",
        "name": "Production",
        "order": 1,
        "updated_at": "2026-01-20T10:00:00.000000Z"
      },
      "id": "1",
      "links": {
        "self": "https://api.modulards.com/api/public/v1/tags/1"
      },
      "type": "tags"
    },
    {
      "attributes": {
        "color": "#00FF00",
        "created_at": "2026-01-20T10:05:00.000000Z",
        "name": "Staging",
        "order": 2,
        "updated_at": "2026-01-20T10:05:00.000000Z"
      },
      "id": "2",
      "links": {
        "self": "https://api.modulards.com/api/public/v1/tags/2"
      },
      "type": "tags"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  }
}

Adds and/or removes tags on the site, with explicit non-toggle semantics: add_tags attaches, remove_tags detaches, and both directions are idempotent (adding a tag the site already carries or removing one it does not carry is a no-op).

Body parameters:

add_tags (integer array): exact ids of the tags to attach. Every tag must belong to your organization.
remove_tags (integer array): exact ids of the tags to detach. Same constraint.

At least one of the two arrays is required, and a tag id present in both answers 422. Answers 200 with the site document; pass include=tags to receive the resulting tags relationship.

Adds and/or removes tags on the site, with explicit non-toggle semantics: `add_tags` attaches, `remove_tags` detaches, and both directions are idempotent (adding a tag the site already carries or removing one it does not carry is a no-op). Body parameters: - `add_tags` (integer array): exact ids of the tags to attach. Every tag must belong to your organization. - `remove_tags` (integer array): exact ids of the tags to detach. Same constraint. At least one of the two arrays is required, and a tag id present in both answers 422. Answers 200 with the site document; pass `include=tags` to receive the resulting tags relationship.

Authentication

AuthorizationBearer

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

Path parameters

sitestringRequired

Query parameters

includestringOptional

Optional: include the site’s resulting tags relationship in the response document

Request

This endpoint expects an object.

add_tagslist of doublesOptional

remove_tagslist of doublesOptional

Response

200 - Tags updated

dataobjectOptional

includedlist of objectsOptional

jsonapiobjectOptional