Skip to main content
POST

Dismiss Suggestion

Marks an account as not a competitor, so the brand brain never suggests it to this workspace again. Send the network and handle of suggestion in Get brand. The brand itself doesn’t change: no new version, and competitors stays as it is. It needs no current suggestion, and dismissing the same account twice changes nothing. The answer has the next suggestion, if there is one. Ask the person before you dismiss for them.
The body must be JSON, sent with Content-Type: application/json. A form body or any other content type is refused with 415. The query string is not read, so workspace_id goes in the body too.

Request

integer
required
The ID of the workspace, from List workspaces
string
required
The suggestion’s network: bluesky, mastodon, youtube or twitter
string
required
The suggestion’s handle, as Get brand gives it

Response

data is the brand object, with the next suggestion:
(The brand object is shortened here. The full answer is the same as Get brand.)

Code Examples

Error Codes

Unauthorized
Missing or invalid API token
Forbidden
The key does not have the brand:update permission, or the key’s person is not an owner or manager of the workspace: You do not have permission to edit workspace.
Unsupported Media Type
The body is not JSON: Send the body as JSON.
Unprocessable Entity
workspace_id is missing, not a number, or a workspace the key’s person is not in (Invalid workspace ID.). network is not one a suggestion can be on (Network is bluesky, mastodon, youtube or twitter.). handle is missing, or is not a handle on that network, such as That is not a handle on Mastodon. Nothing is saved.