---
title: "Dismiss an attention item"
method: POST
path: "/v1/attention/{id}/dismiss"
tags: ["Attention"]
---

# Dismiss an attention item

`POST /v1/attention/{id}/dismiss`

## Request

- Base URL: `https://api.mentio.dev`
- URL: `https://api.mentio.dev/v1/attention/{id}/dismiss`
- Auth: HTTP bearer

Put an item away. It leaves the open list and does not come back while its condition lasts; once the condition clears, a new episode may open a new item. Idempotent.

## Path parameters

- `id` string, required: Attention item id (att_...).

## Response `200`

The dismissed item

- AttentionItem
  - `id` string, required: Attention item id (att_...).
  - `kind` 'mention.spike' | 'sentiment.negative_spike' | 'keyword.noisy' | 'channel.failing' | 'feed.failing' | 'feed.recovered', required: mention.spike: far more mentions in the last hour than the keyword usually gets. sentiment.negative_spike: the negative share of the last 24 hours jumped. keyword.noisy: most scored matches are noise. channel.failing: the channel's last sends all failed. feed.failing: a workspace feed failed its last 3 hourly reads. feed.recovered: it read again after failing.
  - `status` 'open' | 'resolved' | 'dismissed', required: open: the condition holds. resolved: it no longer does. dismissed: a person put it away; it does not come back for the same episode.
  - `subject` object, required: What the item is about.
    - `type` 'keyword' | 'channel' | 'feed', required: keyword, channel or feed.
    - `id` string, required: The keyword (kw_...), the channel (dest_...) or the feed (fd_...).
  - `title` string, required: One line for a person: what happened.
  - `openedAt` string, required: When the condition was first seen.
  - `resolvedAt` string, nullable, required: When it no longer held; null while it does.
  - `dismissedAt` string, nullable, required: When a person dismissed it; null if nobody did.
  - `data` union, required: The facts as they stood when it opened: the same object the account event of the same name carries as `data`.
    - MentionSpikeEventData
      - `attentionId` string, required: The attention item (att_...): GET /v1/attention lists it, POST /v1/attention/{id}/dismiss puts it away.
      - `url` string, required: Where to look in the dashboard.
      - `keyword` object, required: The keyword the item is about.
        - `id` string, required: Keyword id (kw_...).
        - `term` string, required: The tracked term.
        - `kind` 'brand' | 'competitor' | 'topic', required: brand, competitor or topic.
        - `name` string, required: The keyword as Mentio names it: the term, or "term (Group)" outside the default group.
        - `groupId` string, required: Its group (grp_...).
      - `window` object, required: The stretch of time the counts cover, by match time.
        - `from` string, required: Start, inclusive.
        - `to` string, required: End, exclusive.
      - `matches` integer, required: Fresh matches in the hour: posts published at most 6 hours before they matched. Look-backs and free reviews never count.
      - `relevant` integer, required: Of those, scored relevant so far.
      - `baseline` object, required: What the keyword usually gets.
        - `meanPerHour` number, required: Fresh matches per hour over the baseline.
        - `stddevPerHour` number, required: Their standard deviation.
        - `hours` integer, required: Hours in the baseline: the week before the window, or since the keyword started listening.
    - NegativeSpikeEventData
      - `attentionId` string, required: The attention item (att_...): GET /v1/attention lists it, POST /v1/attention/{id}/dismiss puts it away.
      - `url` string, required: Where to look in the dashboard.
      - `keyword` object, required: The keyword the item is about.
        - `id` string, required: Keyword id (kw_...).
        - `term` string, required: The tracked term.
        - `kind` 'brand' | 'competitor' | 'topic', required: brand, competitor or topic.
        - `name` string, required: The keyword as Mentio names it: the term, or "term (Group)" outside the default group.
        - `groupId` string, required: Its group (grp_...).
      - `window` object, required: The stretch of time the counts cover, by match time.
        - `from` string, required: Start, inclusive.
        - `to` string, required: End, exclusive.
      - `negative` integer, required: Relevant matches scored negative in the window.
      - `relevant` integer, required: Relevant matches in the window.
      - `share` number, required: negative / relevant.
      - `baseline` object, required: What the keyword usually reads.
        - `negative` integer, required: Negative relevant matches in the 7 days before the window.
        - `relevant` integer, required: Relevant matches in those 7 days.
        - `share` number, required: The usual negative share, smoothed so a quiet week still has one.
    - KeywordNoisyEventData
      - `attentionId` string, required: The attention item (att_...): GET /v1/attention lists it, POST /v1/attention/{id}/dismiss puts it away.
      - `url` string, required: Where to look in the dashboard.
      - `keyword` object, required: The keyword the item is about.
        - `id` string, required: Keyword id (kw_...).
        - `term` string, required: The tracked term.
        - `kind` 'brand' | 'competitor' | 'topic', required: brand, competitor or topic.
        - `name` string, required: The keyword as Mentio names it: the term, or "term (Group)" outside the default group.
        - `groupId` string, required: Its group (grp_...).
      - `windowDays` integer, required: The window the noise is measured over, in days (since the keyword's last change when that is inside it).
      - `scored` integer, required: Matches the classifier scored in that window.
      - `relevant` integer, required: Of those, relevant.
      - `noiseShare` number, required: The share scored under the relevance line. Every match bills, relevant or not.
    - ChannelFailingEventData
      - `attentionId` string, required: The attention item (att_...): GET /v1/attention lists it, POST /v1/attention/{id}/dismiss puts it away.
      - `url` string, required: Where to look in the dashboard.
      - `channel` object, required: The channel whose sends fail.
        - `id` string, required: Channel id (dest_...).
        - `kind` 'slack' | 'email' | 'webhook' | 'telegram', required: slack, email, webhook or telegram.
        - `label` string, required: The channel's label.
      - `failures` integer, required: Failed sends in a row within the last 24 hours.
      - `lastError` string, nullable, required: The newest failure, as the transport reported it.
      - `since` string, required: The oldest of those failures.
    - FeedFailingEventData
      - `attentionId` string, required: The attention item (att_...): GET /v1/attention lists it, POST /v1/attention/{id}/dismiss puts it away.
      - `url` string, required: Where to look in the dashboard.
      - `feed` object, required: The workspace feed (GET /v1/feeds/{id}).
        - `id` string, required: Feed id (fd_...).
        - `url` string, required: The feed address.
        - `title` string, nullable, required: The feed's own title, when it has one.
      - `reason` 'login_required' | 'login_expired' | 'blocked' | 'not_found' | 'not_a_feed' | 'unreachable', required: login_required: the feed answers a sign-in or access-denied page (connect it with the forum's sign-in, auth). login_expired: the same on a feed that has a sign-in: copy a fresh cookie. blocked: a 403, a 429 or a bot check. not_found: the feed is gone. not_a_feed: the address answers a page, not RSS or Atom. unreachable: no answer or a server error.
      - `detail` string, nullable, required: What the last failed read saw, in a few words.
      - `failingSince` string, required: When it started failing: the third failed read in a row.
      - `keywordsAffected` integer, required: Live keywords of the workspace that read workspace feeds: what misses its posts while it fails.

## Other responses

- `401`: Missing or invalid API key
- `404`: No such attention item in this workspace

---

[API](https://skmtc.dev/mentio/apis/mentio-api.md) · [All operations](https://skmtc.dev/mentio/apis/mentio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mentio/apis/mentio-api/revisions/b16a21d0ed02?raw)