Set An Account's Tags

PUT

account-tags

account

{companyId}

curl -X PUT "https://api.clustr-ai.com/api/public/account-tags/account/9c4d5e6f-.../" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_ids": ["7f3e1a22-...", "8a4f2b33-..."]}'

curl -X PUT "https://api.clustr-ai.com/api/public/account-tags/account/9c4d5e6f-.../" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_ids": []}'

import requests

# Read the current set first, or you will drop what you did not send.
current = requests.get(
    f"https://api.clustr-ai.com/api/public/account-tags/account/{company_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
).json()["data"]["tags"]

requests.put(
    f"https://api.clustr-ai.com/api/public/account-tags/account/{company_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"tag_ids": [t["id"] for t in current] + [new_tag_id]},
)

{
  "success": true,
  "data": {
    "tag_ids": ["7f3e1a22-...", "8a4f2b33-..."]
  }
}

{
  "success": false,
  "error": {
    "message": "unknown tag: 00000000-0000-0000-0000-000000000000",
    "code": "BAD_REQUEST"
  }
}

{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}

Sets which tags an account carries.

This REPLACES the account’s tags. It is not an add. Send every tag the account should end up with — including the ones it already has — or the ones you leave out are removed.Send {"tag_ids": []} to clear them all.

A replace rather than add/remove verbs because the picker that drives it already holds the account’s full set, which makes one request idempotent: the same body sent twice leaves the same tags. Add/remove would make every caller diff, and a dropped request would leave a set nobody intended.

Path Parameters

string

required

The account’s company_id — the company UUID — from List Accounts.Not the account’s id, which is its LinkedIn numeric id. Both ship on every account row; this endpoint takes the UUID, because a tag assignment is keyed the same way the account’s workflow state is.

Body

string[]

required

The complete set of tag ids the account should carry, from List Account Tags. An id belonging to another workspace is rejected.

curl -X PUT "https://api.clustr-ai.com/api/public/account-tags/account/9c4d5e6f-.../" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_ids": ["7f3e1a22-...", "8a4f2b33-..."]}'

curl -X PUT "https://api.clustr-ai.com/api/public/account-tags/account/9c4d5e6f-.../" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_ids": []}'

import requests

# Read the current set first, or you will drop what you did not send.
current = requests.get(
    f"https://api.clustr-ai.com/api/public/account-tags/account/{company_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
).json()["data"]["tags"]

requests.put(
    f"https://api.clustr-ai.com/api/public/account-tags/account/{company_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"tag_ids": [t["id"] for t in current] + [new_tag_id]},
)

{
  "success": true,
  "data": {
    "tag_ids": ["7f3e1a22-...", "8a4f2b33-..."]
  }
}

{
  "success": false,
  "error": {
    "message": "unknown tag: 00000000-0000-0000-0000-000000000000",
    "code": "BAD_REQUEST"
  }
}

{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}

curl -X PUT "https://api.clustr-ai.com/api/public/account-tags/account/9c4d5e6f-.../" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_ids": ["7f3e1a22-...", "8a4f2b33-..."]}'

curl -X PUT "https://api.clustr-ai.com/api/public/account-tags/account/9c4d5e6f-.../" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_ids": []}'

import requests

# Read the current set first, or you will drop what you did not send.
current = requests.get(
    f"https://api.clustr-ai.com/api/public/account-tags/account/{company_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
).json()["data"]["tags"]

requests.put(
    f"https://api.clustr-ai.com/api/public/account-tags/account/{company_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"tag_ids": [t["id"] for t in current] + [new_tag_id]},
)

{
  "success": true,
  "data": {
    "tag_ids": ["7f3e1a22-...", "8a4f2b33-..."]
  }
}

{
  "success": false,
  "error": {
    "message": "unknown tag: 00000000-0000-0000-0000-000000000000",
    "code": "BAD_REQUEST"
  }
}

{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Record Activity

Lists

Tags

Account Tags

Target Accounts

Client Companies

ICP

Competitor Monitoring

Connector Refresh

Notifications

Set An Account's Tags

Path Parameters

Body

​Path Parameters

​Body

Path Parameters

Body