Release a range of nights
Removes the block you pushed under this external_uid and frees the nights it
still holds.
It frees only the nights that block is holding. A night that is unavailable for another reason — the property’s own owner closed it, or a Maat booking has since taken it — stays unavailable. Releasing a block is not the same as declaring those dates open.
Idempotent: releasing a block that does not exist, or releasing the same one
twice, is 204. There is nothing to retry and nothing has gone wrong.
There is no partial release. Send the whole block or move it with a PUT.
Live in a sandbox workspace. Returns 501 against a production one, where no
block was ever applied and so none can be released.
Authorizations
A short-lived partner token, obtained by exchanging your API key at
POST /token. Send it as Authorization: Bearer <access_token>.
Tokens live for fifteen minutes by default and never for more than an hour. Mint one per batch of work, not one per request.
The token carries the workspace and the environment its key was issued for. You cannot change either by asking: the exchange ignores everything in the request body for exactly that reason.
Never send it as a cookie or in a query string, and never store it — store the API key, mint tokens from it.
Path Parameters
Your own identifier for the block, typically your reservation id. Unique to you.
1 - 255Response
The block is gone, or was never there. No body either way.