# Request a manual amendment (/docs/api-reference/hotel-manual-amendments/create-manual-amendment)

`POST /v1/order-items/{id}/manual-amendments`

Requests a manual change to a confirmed hotel booking.

Requires an `Idempotency-Key` header (a UUID) and an API key with order-manage permission. Send the
requested change as `attributes`: new `checkInDate` and `checkOutDate`, `holder` or
`roomGuests` (one entry per booked room, `roomIndex` 1-based); anything omitted keeps its booked
value. Returns `{ amendmentId }`; the request starts as `Pending` and nothing is charged until you
approve a quote.
            
The order item must be fulfilled, not refunded, use the manual amendment flow and have no open request
(`Pending`, `InProgress`, `Quoted` or `PartnerApproved`). Errors: 400 / 21100 invalid
request, 21101 booking not amendable, 21102 a request is already open, 21104 manual amendments not available,
21113 or 21114 invalid or unsupported room and guest changes; 404 / 10004 when the order item is not found.
            
The same key after the request finished gives 409 / 12000: read the request it created with
`GET /order-items/{id}/amendments`. While it is still running the key gives 409 / 12002 with
`Retry-After`, and with a different body 409 / 12001.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `id` | path | yes | `string` | The hotel order item's `id`, from `items[].id` of the order. |
| `Idempotency-Key` | header | yes | `string` | UUID idempotency key for safe retries of this operation. |

## Request body

- `application/json`: `ManualAmendmentCreateRequest`
- `text/json`: `ManualAmendmentCreateRequest`
- `application/*+json`: `ManualAmendmentCreateRequest`

## Responses

### 200

OK

- `text/plain`: `ManualAmendmentResult`
- `application/json`: `ManualAmendmentResult`
- `text/json`: `ManualAmendmentResult`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 409

The idempotency key: it was used by a request that finished (12000), so use a new key for a new request; a request with this key is still running (12002): send the same request, key and body again after Retry-After seconds; or it was used for a different request (12001).

- `application/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

### 503

Idempotency state is temporarily unavailable; retry the same request and key.

- `application/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.