Sign in
BlockActions

Allow to modify a block

Use this call to modify a block.<br>You must have at least one of these scopes: 'blocks.manage, reservations.manage'.

put/booking/v1/block-actions/{id}/amend

Path parameters

idstring required

Id of the block to be modified.

Request body

fromstring required

Start date and time from which the inventory will be blocked<br />Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

tostring required

End date and time until which the inventory will be blocked. Cannot be more than 5 years after the start date.<br />Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

marketSegmentIdstring nullable

Market segment ID for this block

status'Tentative' | 'Definite' | 'Canceled' | 'Optional' nullable

The status to transition the block to as part of this edit. When omitted, the block keeps its current status and the amend is a plain update. Requires the optional block status feature to be enabled (unless the block is already in status Optional). 'Canceled' is not supported here; use the cancel action. Changing the status to Optional requires OptionalCutoff, IsOptionalDeductingInventory and OptionalCutoffBehavior.

optionalCutoffstring nullable

The date and time by which a decision should be made on this optional block. Requires the optional block status feature to be enabled. Required when changing the block's status to Optional.<br />Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

isOptionalDeductingInventoryboolean nullable

Whether this optional block reduces availability like a definite block. Requires the optional block status feature to be enabled (unless the block is already in status Optional). Required when changing the block's status to Optional.

optionalCutoffBehavior'DoNothing' | 'AutoRelease' nullable

What happens when the optional cutoff date is reached. Requires the optional block status feature to be enabled (unless the block is already in status Optional). Required when changing the block's status to Optional.

Example request

{
  "from": "2026-09-06",
  "to": "2026-09-09",
  "grossDailyRate": {
    "amount": 160,
    "currency": "EUR"
  },
  "timeSlices": [
    {
      "blockedUnits": 3
    },
    {
      "blockedUnits": 0
    },
    {
      "blockedUnits": 7
    }
  ],
  "marketSegmentId": "BUSR"
}

Response

Replace of the block was successful.

Changes

No recorded changes to this endpoint across all 1 revision of this API.