Brand
Accept Suggestion
Add the brand’s suggested competitor to its competitors
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
The ID of the workspace, from List workspaces
409.
Response
data is the brand object after the save, with the new competitor at the end of competitors:
Code Examples
Error Codes
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.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.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.