---
title: "Delete a review from a custom partner"
method: DELETE
path: "/reviews/{review_id}"
tags: ["Reviews"]
---

# Delete a review from a custom partner

`DELETE /reviews/{review_id}`

## Request

- Base URL: `https://api.partoo.co/v2`
- URL: `https://api.partoo.co/v2/reviews/{review_id}`
- Auth: API key in header `x-APIKey`
- TypeScript: <https://skmtc.dev/partoo/apis/partoo-rest-api/docs/reviews/:review_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint lets you delete a review your organization pushed through a **custom review
partner**. Reviews synchronized natively by Partoo (Google, Facebook, TripAdvisor…) cannot
be deleted this way.

The deletion is a soft one: the review is kept with `state: deleted` and its author masked,
which is what lets a later
[push of the same `external_id`](/api-reference/reviews/push-a-review-from-a-custom-partner)
bring it back. Deleted reviews are excluded from statistics, and from searches that filter
them out with `state__notin=deleted`.

Deleting a review you already deleted answers `204` as well, so a retry is always safe.
The `review_updated` webhook fires on the first deletion only.

You must use an API key with `ORG_ADMIN` rights and the `review_edit` permission.

## Path parameters

- `review_id` integer, required: Review id

## Response `204`

The review is deleted

- object
  - `status` 'success'

## Other responses

- `401`: You are not authenticated
- `403`: You are not allowed to perform this action. Either: - the API key's user is not an `ORG_ADMIN` or lacks the `review_edit` permission (`errors.authorization`), - the review was not pushed by a custom partner, or your organization is no longer enabled for that partner (`errors.json`).
- `404`: No such review. A review belonging to another organization answers `404` too, and is deliberately indistinguishable from an unknown id.

## Changes

- **2026-11-03** `dcb8190f5a29`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/partoo/apis/partoo-rest-api/changes/reviews/:review_id/delete.md)

---

[API](https://skmtc.dev/partoo/apis/partoo-rest-api.md) - [All operations](https://skmtc.dev/partoo/apis/partoo-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/partoo/apis/partoo-rest-api/revisions/dcb8190f5a29?raw)