Browse the documentation

List Prompt Tags

List the tags this workspace has assigned to a brand's prompts. Pass a tag's slug as `query_tag` on other endpoints.

GET /queries/tags

Query parameters

Name	Type	Description
brand required	string	Tracked brand name, exactly as returned by listTrackedBrands.

Example request

curl -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
  "https://app.mentionbird.ai/api/v1/queries/tags?brand=Acme"

Example response

Recorded from a live call against a demo workspace, so the shape is exactly what the endpoint returns.

{
  "has_more": false,
  "items": [
    {
      "color": "#0075ca",
      "name": "Comparison",
      "slug": "comparison"
    }
  ],
  "returned_count": 1,
  "total_count": 1
}

Responses

200: Prompt tags.
400: Validation error — check the message in `error.message`.
401: Unauthorized — missing, invalid or revoked bearer token.
403: Forbidden — plan lacks API access, or key is read-only.
404: Not found — the brand, prompt or resource does not exist.
405: Method not allowed.
500: Internal error — logged; retry is safe for reads.