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.