Skip to main content
PATCH
Sets which tier a target account belongs to, using the name your workspace uses or the tier’s Clustr ID. This is a separate endpoint from the account’s own fields on purpose: a tier belongs to the company behind the target account (the same record the Accounts and People tables show a tier on), so setting one here and setting one in the app write the same thing. Send one of the two. tier_id wins if you send both.
Tier names are yours. One workspace uses “A / B / C”, the next uses “Strategic / Growth / Watch”. An unknown name is rejected rather than created, and the error lists where to find the real ones, so read the vocabulary before writing to it.
409 means the account has not matched a company yet. A tier attaches to the company behind an account, so until Clustr has matched one there is nothing to file. The fix is to add or correct the account’s LinkedIn URL, which makes the match exact. This is the one failure here that is about your data rather than your request.

Authorizations

Authorization
string
header
required

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

Path Parameters

target_account_id
string<uuid>
required

Body

application/json
tier
string
tier_id
string

Response

The account, with its new tier.

success
boolean
required
data
object
required