Remove Subscriber Tags
Detach tags from a contact.
MethodDELETE
/api/v2/subscribers/:subscriber/tagsDetaches tags from a contact. Emits tag.removed events. Permission: subscribers.
Pass tags as a JSON array in the query string.
Path Parameters
| Name | Type | Description |
|---|---|---|
subscriber | string | Required. Subscriber id or email. |
Query Parameters
| Name | Type | Description |
|---|---|---|
tags | string | Required. JSON array of tag names, e.g. ["customer"]. |
Response Fields
| Field | Type | Description |
|---|---|---|
removedCount | integer | Associations removed. |
message | string | Optional status text. |
Errors
| Status | name | When |
|---|---|---|
| 401 | missing_api_key | Missing or invalid bearer token |
| 403 | missing_permission | Token lacks the subscribers permission |
| 404 | not_found | Unknown subscriber |
| 422 | validation_error | tags is not a JSON array of strings |