---
title: "Create Hold"
method: POST
path: "/api/v1/bookings/hold"
---

# Create Hold

`POST /api/v1/bookings/hold`

## Request

- Base URL: `https://trovastorage.it` (the document declares no server; this is the origin it was published from)
- URL: `https://trovastorage.it/api/v1/bookings/hold`
- Auth: one of:
  - API key in header `X-Access-Token`
  - HTTP bearer

## Request body

- HoldRequest
  - `unit_id` string, uuid, required
  - `start_date` string, date, required
  - `term_months` integer, nullable

## Response `201`

Successful Response

- BookingResponse
  - `id` string, uuid, required
  - `unit_id` string, uuid, required
  - `state` string, required
  - `start_date` string, date, required
  - `end_date` string, date, nullable, required
  - `hold_expires_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/trovastorage/apis/stock-your-inventory.md) · [All operations](https://skmtc.dev/trovastorage/apis/stock-your-inventory/llms.txt) · [OpenAPI document](https://skmtc.dev/trovastorage/apis/stock-your-inventory/revisions/c75f591a585c?raw)