---
title: "Amend a booking / resolve needs_input"
method: POST
path: "/v1/bookings/{booking_id}/modify"
---

# Amend a booking / resolve needs_input

`POST /v1/bookings/{booking_id}/modify`

## Request

- Base URL: `https://mercantry.org`
- URL: `https://mercantry.org/v1/bookings/{booking_id}/modify`
- Auth: none declared

In needs_input: pass accept_option_index to take a merchant-offered time (confirms immediately) or amend datetime/party_size to re-queue. Modifying a confirmed booking cancels and rebooks (new booking_id returned).

## Path parameters

- `booking_id` string, uuid, required

## Request body

- object
  - `datetime` string
  - `party_size` integer
  - `window_minutes` integer
  - `accept_option_index` integer

## Response `200`

Updated state.

## Other responses

- `400`: invalid_option_index | booking_in_terminal_state.
- `404`: unknown_booking.

---

[API](https://skmtc.dev/mercantry/apis/registry-agent-native-merchant-registry-rest-mirror.md) · [All operations](https://skmtc.dev/mercantry/apis/registry-agent-native-merchant-registry-rest-mirror/llms.txt) · [OpenAPI document](https://skmtc.dev/mercantry/apis/registry-agent-native-merchant-registry-rest-mirror/revisions/0a9bf614fe96?raw)
