Tag mentions

Puts one tag on one or more mentions.

POST https://cotlet.dev/api/v1/brand24/projects/{project_id}/mentions/tag

write Confirm

Tags the mentions in your project; teammates who open the project see the tag. Brand24 documents no way to remove a tag from a mention, so the tool has no undo. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: tag_mentions
NameTypeDescription
project_id integer required integer Project ID from list_projects.
mention_ids string[] required string[] Mention IDs from list_mentions.
tag string required string Tag name from list_tags. A name that does not exist creates a new tag.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/brand24/projects/123456789/mentions/tag \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mention_ids":["7001234520","7001234521","7001234522"],"tag":"Complaint"}'
Python
result = client.call("brand24", "tag_mentions", {"project_id":123456789,"mention_ids":["7001234520","7001234521","7001234522"],"tag":"Complaint"})
Node.js
const result = await cotlet.call('brand24', 'tag_mentions', {"project_id":123456789,"mention_ids":["7001234520","7001234521","7001234522"],"tag":"Complaint"});
CLI
cotlet call brand24 tag_mentions --data '{"project_id":123456789,"mention_ids":["7001234520","7001234521","7001234522"],"tag":"Complaint"}'

Example response

JSON

{
  "tagged": 3,
  "tag": "Complaint",
  "tag_created": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.