Skip to content
MentionBird.ai
Browse the documentation

Rename or Recolor a Tag

Rename a prompt tag or change its color. The prompts carrying it keep it, and its slug follows the new name. Requires a write-enabled API key.

POST /queries/tags/update

Request body

Send as application/json. This endpoint needs a write-enabled API key.

Field Type Description
brand required string Tracked brand name.
tag required string The tag's name or slug.
name string The new name, up to 100 characters.
color string The new color, e.g. #0075ca.

Example request

curl -X POST -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "brand": "Acme",
  "tag": "Acme"
}' \
  "https://api.mentionbird.ai/api/v1/queries/tags/update"

Responses

200
Done. The body reports the outcome for each item.
400
Validation error — check the message in `error.message`.
401
Unauthorized — missing, invalid or revoked bearer token.
403
Forbidden — the plan lacks API access, the key is read-only, or addTrackedBrand would pass the tracked-brand limit.
404
Not found — the brand, prompt or resource does not exist.
405
Method not allowed.
429
Too many requests — over the key's per-minute or per-day limit. Wait the seconds in the `Retry-After` header, then retry.
500
Internal error — logged; retry is safe for reads.