Delete mentions

Deletes mentions from a project, and can block their source or mark them as spam.

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

write Confirm

Removes the mentions from the project's charts and lists. A block is undone only in the project settings, Sources tab, with delete filter; Brand24 documents no way to restore a deleted mention. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: delete_mentions
NameTypeDescription
project_id integer required integer Project ID from list_projects.
mention_ids string[] required string[] Mention IDs from list_mentions.
block_source boolean boolean Also block the domain or social media author of each mention in this project (Delete and Block). Default false.
mark_spam boolean boolean Report the mentions as SPAM. Default false.

Request

cURL
curl -X DELETE "https://cotlet.dev/api/v1/brand24/projects/123456789/mentions?mention_ids=7001234510&mention_ids=7001234511&block_source=true&mark_spam=false" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("brand24", "delete_mentions", {"project_id":123456789,"mention_ids":["7001234510","7001234511"],"block_source":True,"mark_spam":False})
Node.js
const result = await cotlet.call('brand24', 'delete_mentions', {"project_id":123456789,"mention_ids":["7001234510","7001234511"],"block_source":true,"mark_spam":false});
CLI
cotlet call brand24 delete_mentions --data '{"project_id":123456789,"mention_ids":["7001234510","7001234511"],"block_source":true,"mark_spam":false}'

Example response

JSON

{
  "deleted": 2,
  "blocked_sources": [
    "coupon-deals.example"
  ],
  "marked_spam": 0
}

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.