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 replace may have removed tags you did not mention.
A bare replace is the whole set. {"tag_ids": [], "mode": "replace"} clears every tag on the account. Send group_id when you mean one field, or use add and remove.

Authorizations

Authorization
string
header
required

The API key you created on the API settings page of the Clustr app.

Path Parameters

account_id
string
required

The account: its acc_ Clustr id, or the company uuid.

Body

application/json
tag_ids
string[]
required

The tags' ids (Clustr ids, tag_...). With replace, [] takes every tag off.

mode
enum<string>
default:replace

replace (default) leaves exactly these tags, add keeps the others, remove takes these off.

Available options:
replace,
add,
remove

Response

Typed result envelope.

success
boolean
required
data
object
required