Update mention with the Mention API

Curates a mention: marks it read or favorite, moves it to a folder, sets its tone or tags it, and returns it. Only the fields sent change. The content of a mention never changes.

Identifier
mention_update_mention

The request

POST https://connect.reportei.com/api/tools/mention_update_mention/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "account_id": "<account_id>",
    "alert_id": "<alert_id>",
    "mention_id": "<mention_id>"
  }
}

Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.

Parameters

ParameterTypeRequiredDescription
account_idstringYesId of the account, from Get account.
alert_idstringYesId of the alert, from List alerts.
mention_idstringYesId of the mention, from List mentions.
readbooleanNotrue marks the mention as read.
favoritebooleanNotrue marks the mention as favorite, which also marks it as read. Needs the admin role on the alert.
trashedbooleanNotrue puts the mention in the trash. Needs the admin role on the alert.
folderstringNoFolder to move the mention to.Values: inbox, archive, spam, trash
toneintegerNoTone of the mention: -1 negative, 0 neutral, 1 positive.Values: -1, 0, 1
tagsarrayNoTags of the mention, each an existing tag of the alert by its id from List tags. Send every tag the mention should have.

Supported connections

Your customer connects their Mention account once, with one of the modes below. The same connection serves every tool of the toolkit.

API key

Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.

The response

On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.

Ready for AI agents

This tool's input is a JSON Schema, available at GET /api/tools/mention_update_mention. It becomes your agent's tool definition with no conversion.

Other Mention tools

See all 10 tools

Toolkits in the same category

See all 100 toolkits

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.