Update a website's tags

PATCH

https://api.modulards.com/api/public/v1/sites/:site/tags

PATCH

/api/public/v1/sites/:site/tags

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
  ]
}'

200Update a website's tags

{
  "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 tags to a website, removes tags from it, or both in one call. Use it to change a website’s labels without resending the whole list.

Repeating a call is safe: adding a tag the website already carries, or removing one it does not carry, changes nothing. Returns the website.

Body

add_tags (array of integers, required unless remove_tags is sent): ids of the tags to attach.
remove_tags (array of integers, required unless add_tags is sent): ids of the tags to detach.

Errors

422: a tag id appears in both lists or matches no tag. The id of a tag that belongs to another organization is ignored, not rejected.

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

Set to tags to embed the website's resulting tags in the answer.

Request

This endpoint expects an object.

add_tagslist of doublesOptional

remove_tagslist of doublesOptional

Response

200 - Tags updated

dataobjectOptional

includedlist of objectsOptional

jsonapiobjectOptional