---
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.rumoro.dev`
- URL: `https://api.rumoro.dev/v1/attention/{id}/dismiss`
- Auth: HTTP bearer

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.

## Path parameters

- `id` string, required: The attention item's id (att_...).

## Response `200`

The item, now dismissed

- AttentionItem
  - `id` string, required: The attention item's id (att_...).
  - `kind` 'mention.spike' | 'sentiment.negative_spike' | 'keyword.noisy' | 'channel.failing', required: mention.spike flags an hour with far more mentions than usual, and sentiment.negative_spike a jump in the negative share over 24 hours. keyword.noisy flags a keyword whose scored matches are mostly noise, and channel.failing a channel whose recent sends all failed.
  - `status` 'open' | 'resolved' | 'dismissed', required: open means the condition is still true. resolved means it is not anymore. dismissed means someone dismissed it, and it will not reopen for the same episode.
  - `subject` object, required: The keyword or channel the item concerns.
    - `type` 'keyword' | 'channel', required: Either keyword or channel.
    - `id` string, required: The keyword's id (kw_...) or the channel's id (dest_...).
  - `title` string, required: A one-line summary of what happened.
  - `openedAt` string, required: First time the condition was seen.
  - `resolvedAt` string, nullable, required: When the condition ended. Null while it lasts.
  - `dismissedAt` string, nullable, required: When someone dismissed it. Null if no one did.
  - `data` union, required: The numbers at the time it opened. This is the same object the account event with the same name sends as `data`.
    - MentionSpikeEventData
      - `attentionId` string, required: Related attention item (att_...). See GET /v1/attention, dismiss with POST /v1/attention/{id}/dismiss.
      - `url` string, required: The dashboard page to open.
      - `keyword` object, required: The keyword this item concerns.
        - `id` string, required: The keyword's id (kw_...).
        - `term` string, required: The term being tracked.
        - `kind` 'brand' | 'competitor' | 'topic', required: The keyword's kind, brand, competitor or topic.
        - `name` string, required: The keyword's display name. It is the term, or "term (Group)" when the keyword is not in the default group.
        - `groupId` string, required: The keyword's group id (grp_...).
      - `window` object, required: Match-time range of the counts.
        - `from` string, required: Start time, included.
        - `to` string, required: End time, not included.
      - `matches` integer, required: New matches during the hour, meaning posts that matched within 6 hours of being published. Look-backs and free reviews are not counted.
      - `relevant` integer, required: How many of them have been scored relevant so far.
      - `baseline` object, required: The keyword's normal volume.
        - `meanPerHour` number, required: Average new matches per hour during the baseline.
        - `stddevPerHour` number, required: The standard deviation of that average.
        - `hours` integer, required: How many hours the baseline covers. It is the week before the window, or the time since the keyword was created if that is shorter.
    - NegativeSpikeEventData
      - `attentionId` string, required: Related attention item (att_...). See GET /v1/attention, dismiss with POST /v1/attention/{id}/dismiss.
      - `url` string, required: The dashboard page to open.
      - `keyword` object, required: The keyword this item concerns.
        - `id` string, required: The keyword's id (kw_...).
        - `term` string, required: The term being tracked.
        - `kind` 'brand' | 'competitor' | 'topic', required: The keyword's kind, brand, competitor or topic.
        - `name` string, required: The keyword's display name. It is the term, or "term (Group)" when the keyword is not in the default group.
        - `groupId` string, required: The keyword's group id (grp_...).
      - `window` object, required: Match-time range of the counts.
        - `from` string, required: Start time, included.
        - `to` string, required: End time, not included.
      - `negative` integer, required: Relevant matches in the window with negative sentiment.
      - `relevant` integer, required: Relevant match count for the window.
      - `share` number, required: negative divided by relevant.
      - `baseline` object, required: The keyword's normal sentiment.
        - `negative` integer, required: How many relevant matches were negative in the prior week.
        - `relevant` integer, required: Relevant match count for those 7 days.
        - `share` number, required: The normal share of negative matches, smoothed so that a quiet week still gives a value.
    - KeywordNoisyEventData
      - `attentionId` string, required: Related attention item (att_...). See GET /v1/attention, dismiss with POST /v1/attention/{id}/dismiss.
      - `url` string, required: The dashboard page to open.
      - `keyword` object, required: The keyword this item concerns.
        - `id` string, required: The keyword's id (kw_...).
        - `term` string, required: The term being tracked.
        - `kind` 'brand' | 'competitor' | 'topic', required: The keyword's kind, brand, competitor or topic.
        - `name` string, required: The keyword's display name. It is the term, or "term (Group)" when the keyword is not in the default group.
        - `groupId` string, required: The keyword's group id (grp_...).
      - `windowDays` integer, required: How many days the noise is measured over. If the keyword changed within that time, it starts at the change.
      - `scored` integer, required: Matches scored by the classifier during that time.
      - `relevant` integer, required: How many of them were relevant.
      - `noiseShare` number, required: The part that scored below 40. Every match is billed, relevant or not.
    - ChannelFailingEventData
      - `attentionId` string, required: Related attention item (att_...). See GET /v1/attention, dismiss with POST /v1/attention/{id}/dismiss.
      - `url` string, required: The dashboard page to open.
      - `channel` object, required: The channel that keeps failing.
        - `id` string, required: The channel's id (dest_...).
        - `kind` 'slack' | 'email' | 'webhook' | 'telegram', required: Type of channel.
        - `label` string, required: The name you gave the channel.
      - `failures` integer, required: Consecutive failed sends in the past 24 hours.
      - `lastError` string, nullable, required: The latest error, as Slack, email, the webhook or Telegram returned it.
      - `since` string, required: Time of the first of those failures.

## Other responses

- `401`: The API key is missing or not valid
- `404`: This workspace has no attention item with this id

---

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