您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。
Set creator account tags
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

FieldTypeRequiredDescription
idintegerNoCreator account ID
idsinteger[]NoCreator account IDs
tagNamesstring[]YesTag names
appendbooleanNoAppend 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.

FieldTypeRequiredDescription
codeintegerYes—
messagestringYes—
datanullYes—
timestampintegerYes—

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