# Review.withheld

URL: /business/events/Review.withheld · Id: `event:Review.withheld`

> Emitted each time a Review is withheld.

[Review.withhold](/business/nouns/review/withhold) emits `Review.withheld` when it completes on a [Review](/business/nouns/review).

| Property | Value |
| --- | --- |
| Emitted by | [Review.withhold](/business/nouns/review/withhold) |
| Noun | [Review](/business/nouns/review) |
| Moves | [Review](/business/nouns/review) `submitted` to `withheld`; [Review](/business/nouns/review) `published` to `withheld` |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Review.withhold](/business/nouns/review/withhold) returns, and `previous` holds the state it left.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Review.withheld`. |
| `at` | `datetime` | Yes | When it happened. |
| `seq` | `integer` | No | Its position in the namespace, one more than the Event before; any seq is a cursor into the history. |
| `data` | `json` | Yes | The Thing as the Action left it. |
| `data.review` | [Review](/business/nouns/review) | Yes | The Review, now `withheld`. |
| `data.review.rating` | `integer` | Yes | The score, from 1 to 5. |
| `data.review.body` | `text` | No | The reviewer’s words. |
| `data.review.venue` | `string` | No | The venue it was posted on, by id; empty for the Startup’s own Site. |
| `data.review.displayConsent` | `boolean` | No | True once the reviewer agreed it may be shown on the Startup’s own Pages. |
| `data.review.status` | `string` | Yes | Where it stands; a removed Review is kept, never deleted. |
| `data.review.customer` | [Customer](/business/nouns/customer) | No | The Customer who wrote it, when known. |
| `data.previous.status` | `string` | Yes | The `status` before this Event: `submitted`. |

### Example
```json
{
  "$id": "https://api.sb/kilnbakery.com/events/event_1",
  "$type": "Event",
  "name": "Review.withheld",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "review": {
      "$id": "https://api.sb/kilnbakery.com/reviews/review_1",
      "$type": "Review",
      "rating": 1,
      "body": "Example body",
      "venue": "Example venue",
      "displayConsent": true,
      "status": "withheld",
      "customer": "customer_1"
    },
    "previous": {
      "status": "submitted"
    }
  },
  "seq": 1
}
```