Skip to main content
PUT
One endpoint, three verbs, chosen with mode. The response is the account’s tags read back after the write, not an echo of what you sent: a single-select group may have swapped out a tag you did not mention.

​
Path Parameters

​
string
required
The account’s company_id (the company UUID), from List Accounts.

​
Body

​
string[]
required
Tag ids from a group whose subject_type is account, from List Tag Groups.
​
string
default:"replace"
  • replace leaves the account carrying exactly tag_ids (within group_id when you send one). This is the picker’s verb.
  • add keeps the account’s other tags. This is the verb for an automation: it knows the one tag it means and must not drop what a person put there.
  • remove takes these tags off and leaves the rest.
​
string
Narrows a replace to one group, so replacing a Segment tag leaves every other group alone. Without it, replace means the account’s whole set.
A bare replace is the whole set. {"tag_ids": [], "mode": "replace"} clears every tag on the account. Send group_id when you mean one group, or use add and remove.
A single-select group swaps rather than stacks. Adding a second tag from a single group replaces the one already there, which is what makes a status behave like a status.