---
title: "Dismiss a suggestion"
method: POST
path: "/suggestions/{suggestionId}/dismiss"
tags: ["entities"]
---

# Dismiss a suggestion

`POST /suggestions/{suggestionId}/dismiss`

## Request

- Base URL: `https://shruwd.io/api/v1`
- URL: `https://shruwd.io/api/v1/suggestions/{suggestionId}/dismiss`
- Auth: HTTP bearer

Not a competitor. Quiet for ninety days, after which it may be suggested again if the answers still name it.

## Response `200`

Dismissed.

- Suggestion: A name the answers use that the brand does not track, with the evidence for suggesting it.
  - `suggestionId` string, required
  - `brandId` string, required
  - `name` string, required: The most frequent surface form in the answers.
  - `domainHint` string, nullable, required: The registrable domain of the name's own site, when the answers linked the name to it. A link to someone else's page is a citation, not the name's site, and gives no hint. Used as the entity's domain on acceptance unless overridden.
  - `state` 'open' | 'accepted' | 'dismissed', required
  - `share` number, required: Distinct responses in the cluster that named it, divided by the cluster's responses. In [0, 1].
  - `responses` integer, required
  - `clusterResponses` integer, required
  - `cluster` string, required: `*` for the whole prompt set, otherwise a prompt tag.
  - `samplePromptGroupId` string, nullable, required: One prompt whose answers named it.
  - `firstSeenAt` string, date-time, required
  - `lastSeenAt` string, date-time, required
  - `decidedAt` string, date-time, nullable, required
  - `entityId` string, nullable, required: The competitor it became, once accepted.

## Other responses

- `404`: `not_found`: no such resource in this workspace.
- `409`: `suggestion_decided`.
- `default`: Every failure has this body.

---

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