> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set A Person's Tags

> Add, remove, or replace the tags on one person

Same body and the same three modes as
[Set An Account's Tags](/api-reference/set-account-record-tags), keyed on the
person instead. The response is the person's tags read back after the write.

## Path Parameters

<ParamField path="linkedinId" type="string" required>
  The person's LinkedIn public identifier, as returned in `linkedin_id` by
  [List Connectors](/api-reference/list-connectors).
</ParamField>

## Body

<ParamField body="tag_ids" type="string[]" required>
  Tag ids from a group whose `subject_type` is `person`.
</ParamField>

<ParamField body="mode" type="string" default="replace">
  `replace`, `add` or `remove`. A bare `replace` is the person's whole set.
</ParamField>

<ParamField body="group_id" type="string">
  Narrows a `replace` to one group.
</ParamField>

<Note>
  **Tags on a connector describe the person, not their opportunities.** Every
  opportunity that connector produces is reached through them, so a tag here is
  a claim about the relationship rather than about any one intro. Tag the intro
  itself with [Set An Opportunity's
  Tags](/api-reference/set-path-record-tags).
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT "https://api.clustr-ai.com/api/public/record-tags/person/nicdelaye" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"tag_ids": ["4c8a9b10-2d3e-4f50-8a61-7b2c3d4e5f60"], "mode": "add"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "tags": [
        {
          "id": "4c8a9b10-2d3e-4f50-8a61-7b2c3d4e5f60",
          "group_id": "1d2e3f40-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
          "name": "Employee",
          "color": "#6366F1"
        }
      ]
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": { "message": "unknown tag: 00000000-0000-0000-0000-000000000000", "code": "BAD_REQUEST" }
  }
  ```
</ResponseExample>