---
title: "A staff member's preview of claiming a prize: nothing is claimed or delivered"
method: POST
path: "/api/rewards/grants/{id}/preview"
tags: ["Rewards"]
---

# A staff member's preview of claiming a prize: nothing is claimed or delivered

`POST /api/rewards/grants/{id}/preview`

## Request

- Base URL: `https://api.rewritelifestyle.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rewritelifestyle.ai/api/rewards/grants/{id}/preview`
- Auth: HTTP bearer

Staff only (coach, PC or admin flag; `/rewards/me.claim_mode` is `preview`); anyone else gets a 403. Answers like claim, choose and consent in one call, with `preview: true`: send `catalogue_id` for a choice prize's pick and `consent` to answer a `consent_needed` step. Nothing is reserved, booked, opened or delivered, and no consent is recorded. Afterwards the grant lists as claimed with `staff_preview: true`, and booking or picking for it is refused with `STAFF_PREVIEW_ONLY`.

## Path parameters

- `id` number, required

## Request body

- PreviewGrantClaimDto
  - `catalogue_id` number: A choice prize: catalogue_id of the option picked, from GET grants/:id/options
  - `consent` 'granted' | 'declined': The answer to a `consent_needed` step. Recorded nowhere.

## Response `201`

## Changes

- **2026-10-30** `a4ae031ed87f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/changes/api/rewards/grants/:id/preview/post.md)

---

[API](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api.md) - [All operations](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/revisions/28695827f27a?raw)