# Set creator account tags

- API version: 1.11.0
- Last updated: 2026-11-16
- Server: `https://api.ailingtu.com`
- Web document: [Set creator account tags](/en/openapi/set-creator-tags)
- Full schema: [JSON Schema](/en/openapi/operations/setCreatorAccountTags.json)
- Discovery: [Operation index](/en/openapi/operations/index.json)

## POST /v1/creatorAccount/setTags

Operation ID: `setCreatorAccountTags`

Sets account tags using id or ids and tagNames. The optional append flag controls appending tags.

Authentication: Request header `x-api-key: <YOUR_API_KEY>`; keep the key on the server and never expose it in client code, logs or shared files.

Success criteria: HTTP 2xx with code=0; for asynchronous tasks, also query the final status.

### Request parameters

| Field | Location | Type | Required | Description |
|---|---|---|---|---|
| `id` | body | integer | No | Creator account ID |
| `ids` | body | integer[] | No | Creator account IDs |
| `tagNames` | body | string[] | Yes | Tag names |
| `append` | body | boolean | No | Append tags |

Request format: `application/json`

### Request example

```json
{
  "ids": [
    12345
  ],
  "tagNames": [
    "team-a"
  ],
  "append": false
}
```

### Success response

```json
{
  "code": 0,
  "message": "success",
  "data": null,
  "timestamp": 1790640000000
}
```

### Response fields

Main levels are listed below. The endpoint JSON Schema is authoritative for the full structure, unions and validation rules; Required refers to the containing object.

| Field | Type | Required | Description |
|---|---|---|---|
| `code` | integer | Yes | — |
| `message` | string | Yes | — |
| `data` | null | Yes | — |
| `timestamp` | integer | Yes | — |
