Developer docs / Creator authorization
Set creator account tags
Sets account tags using id or ids and tagNames. The optional append flag controls appending tags.
POST
/v1/creatorAccount/setTags- 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 body fields
| Field | Type | Required | Description |
|---|---|---|---|
id | integer | No | Creator account ID |
ids | integer[] | No | Creator account IDs |
tagNames | string[] | Yes | Tag names |
append | boolean | No | Append tags |
Request body
{
"ids": [
12345
],
"tagNames": [
"team-a"
],
"append": false
}Success response
{
"code": 0,
"message": "success",
"data": null,
"timestamp": 1790640000000
}Response and errors
Main response fields come from the published contract; see the JSON Schema. Required refers to the constraint in the containing object.
| Field | Type | Required | Description |
|---|---|---|---|
code | integer | Yes | — |
message | string | Yes | — |
data | null | Yes | — |
timestamp | integer | Yes | — |
Fix parameter, permission or authorization errors before retrying. If task creation times out, query existing tasks first and do not submit duplicates after an interrupted poll.
Last updated · 2026-11-16