Modifying Tags

Modifying Entity Tags


Modifying an entity's tags can be achieved through the /entities/update endpoint (or via implicit upserts through /entities/create).

curl -X POST \
  https://<API_ENDPOINT>/v1/entities/create \
  -H 'Content-Type: application/json' \
  -H 'u21-key: <YOUR_API_KEY>' \
  -d '{
    "general_data": {
      "entity_id": "371c4d7b-0563-4685-aab1",
      "entity_type": "user",
      "tags": [
        "account_type:market2",
        "sector:europe"
      ]
    }
  }'

Entity-associated tags are considered as list-types on objects, so the standard list merge strategies apply. By default, newly specified tags in a request are unioned with the existing tags on the entity.

Tag deletion can either be achieved with the replace (full replace of the entire list) or difference (set-difference) list merge strategies.

Modify Event Tags


Modifying an event's tags can be achieved through the /events/update endpoint (or via implicit upserts through /events/create). Event-associated tags are considered as list-types on objects, so the standard list merge strategies apply. By default, newly specified tags in a request are unioned with the existing tags on the event.

Tag deletion can either be achieved with the replace (full replace of the entire list) or difference (set-difference) list merge strategies.