Skip to main content
POST
Release a hold (HELD → RELEASED) — idempotent

Authorizations

x-api-key
string
header
required

API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.

Path Parameters

projectId
string
required

The project the hold belongs to.

Minimum string length: 1
Example:

"prj_01kv60qgnef2kt3pvqgwmkbzfr"

reservationId
string
required

The reservationId returned by POST /holds.

Minimum string length: 1
Example:

"resv_01kv8p20m1gnqvxl92xln6awk8"

Response

Released (or already released / converted / not found)

reservationId
string
required
status
enum<string>
required

CONVERTED means the hold was already booked and cannot be released. NOT_FOUND means it never existed or has been garbage-collected. Both are terminal, not errors.

Available options:
RELEASED,
CONVERTED,
NOT_FOUND