Dismiss an attention item
Dismisses an item. It leaves the open list and stays away while its condition lasts. After the condition ends, a new episode can open a new item. Calling it twice has the same effect as once.
Authorization
bearerAuth An API key from POST /v1/api-keys. Keys start with ref_.
In: header
Path Parameters
The attention item's id (att_...).
1 <= lengthResponse Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/attention/att_abc123/dismiss"{ "id": "string", "kind": "mention.spike", "status": "open", "subject": { "type": "keyword", "id": "string" }, "title": "string", "openedAt": "string", "resolvedAt": "string", "dismissedAt": "string", "data": { "attentionId": "string", "url": "string", "keyword": { "id": "string", "term": "string", "kind": "brand", "name": "string", "groupId": "string" }, "window": { "from": "string", "to": "string" }, "matches": 0, "relevant": 0, "baseline": { "meanPerHour": 0, "stddevPerHour": 0, "hours": 0 } }}Get share of voice
Returns each keyword with matches in the period, its counts and its share of all brand and competitor matches. Topic keywords are counted but not part of the split. Pick the period with `range` (7d, 30d, 90d or 365d up to today) or with `from` and `to`. Days follow `timezone`, UTC by default. `keywordIds` and `platforms` narrow the data, and `compare=true` adds the equally long period just before. Dates are publish dates.
List attention items
Lists items that need a person, latest first. Kinds are mention.spike (a keyword's mentions jumped in the last hour), sentiment.negative_spike (its 24-hour negative share jumped), keyword.noisy (it turned noisy) and channel.failing (a channel's recent sends all failed). Checks run hourly. Items open when the condition starts and resolve when it ends. Open items are the default, and `status=all` adds the history. Opening an item also sends an account event of the same name to subscribed webhook, Slack, email and Telegram channels.