Skip to main content
POST

Accept Suggestion

Adds the competitor the brand brain suggests (suggestion in Get brand) to the workspace’s competitors. It saves the same way as adding the competitor by hand in Settings → Brand: a new brand version, and the competitor list is kept as yours. On a paid plan, the account’s public posts are read at once, and watch shows how that goes. The account is never suggested again, even if it is taken off the list later. The answer has the next suggestion, if there is one. Ask the person before you accept 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
Send the network and handle of the suggestion as it is now. If it changed since you read it, nothing is saved and the answer is 409.

Response

data is the brand object after the save, with the new competitor at the end of competitors:
(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.
Conflict
The network and handle are not the brand’s suggestion now: That suggestion changed. Refresh to see the new one. Someone answered it already, it is a competitor already, or newer posts put another account first. Read the brand again for the current suggestion.When there is no suggestion at all, as on a free plan, the message is There is no suggested competitor right now. Reading the brand again shows none, so don’t try again.Either way, nothing is saved.
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 the suggestion can be on (Network is bluesky, mastodon, youtube or twitter.), or handle is missing. Or the brand already has 10 competitors (competitors: Competitors: 10 at most.): take one off with Update brand first. Nothing is saved.