Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Reject a review or question

Turns a review or question down, citing a published rule and explaining why. Both reason_detail and rejection_reason are required, and rejection_reason must be the identifier of an active rejection reason (see Conversation Rejection Reasons). The body is validated before anything else: an invalid body changes nothing and sends no e-mail.

On success:

  • status becomes rejected and is_public becomes false. A published conversation is taken off the storefront and out of the product's review statistics, which are cached: the change can take up to about 20 minutes to show on the product detail page and up to about 25 minutes on search listings.

  • A rejected event is recorded with the staff account the request was made with, the request's audited headers in request_headers (naming the Omnitron user for a request sent through the Omnitron remote proxy), the reason_detail and the cited reason.

  • The author is e-mailed — with the Review Rejected or Question Rejected template, in the author's language — stating that the post was not published, the reason_detail and the reason's text — its translation into the author's language when the reason has one. The e-mail is skipped when the template is switched off through DISABLED_EMAIL_TEMPLATES.

A rejected review does not block its author from writing a new review of the same purchase.

Allowed from pending, from approved (taking a published post down) and from null. Rejecting twice is refused, so the author is never mailed twice for one decision.

post
/conversations/{id}/reject/
Authorizations
AuthorizationstringRequired

Token credential sent in the Authorization header, in the form: Token <your-token>. Requires a staff (admin) account.

Path parameters
idintegerRequired

The unique identifier of the conversation.

Body

The grounds for rejecting a review or question. Both are e-mailed to the author.

reason_detailstring · min: 1 · max: 500Required

The moderator's own explanation of why the post was not published. Must not be blank.

rejection_reasonintegerRequired

The identifier (pk) of the rejection reason cited — the published rule the post broke. Must be an active reason.

Responses
200

The conversation was rejected and is not public.

application/json

The storefront visibility of a conversation after a moderation decision.

is_publicbooleanOptional

true after approval, false after rejection.

post/conversations/{id}/reject/
POST /api/v1/remote/1/conversations/{id}/reject/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 76

{
  "reason_detail": "The third sentence contains a slur.",
  "rejection_reason": 3
}
{
  "is_public": false
}

Last updated

Was this helpful?