Add tags to a mention

Access Tiers: Premium

Rate limit:

  • Bucket: mention-write
  • Limit: 250 requests per 15 minutes

Applies one or more tags to a specific mention. Tags are used to categorize and organize mentions for easier filtering and analysis.

Tag validation:

  • Tag names must be non-empty and cannot contain only whitespace
  • A tag name must be unique within the folder holding it, compared case-insensitively (e.g. "Example" and "example" are treated as the same name)
  • A tag name can carry the folders holding it, separated with a backslash ("") (e.g. "Marketing\Campaigns\Autumn"), and the folders missing on the way are created
  • No part of the path can start with a dot, as "." and ".." name a path segment of their own meaning
  • Maximum length of every part of the path: 255 characters
  • Maximum number of folders holding a tag: 5
  • Maximum tags per request: 50
  • Maximum tags attached to mention: 50

⚠️ WARNING: Due to caching layers tags propagation might take up to 1 minute from the moment tag is assigned.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The unique identifier of the mention to tag

Body Params

Request model for applying tags to a mention

tags
array of strings
required
length between 1 and 50

List of tag names to apply to the mention, each one optionally carrying the folders holding it separated with a backslash (""). Every part of the path must be non-empty and cannot exceed 255 characters, and a tag can be held by at most 5 folders.

tags*
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*
application/json