Bookings

Release a hold

Releases a hold early so its capacity is offered again.

Esta página aún no está disponible en tu idioma.

DELETEhttps://api.maple.inc/v1/booking_holds/{holdId}API key

Releases a hold early so its capacity is offered again. Idempotent: releasing a hold that already expired or was released succeeds; a hold already consumed by a booking answers 409 hold_consumed. Unknown holds and holds owned by another app return 404. Provider-managed locations cannot release early: the call succeeds without changing the lock or quota usage; expiry or consumption frees it. Requires bookings:write.

Authorization

Send your API key as Authorization: Bearer <key>: mpk_test_… against the sandbox (https://api.staging.maple.inc/v1), mpk_live_… against production. See Authentication. The samples read the key from MAPLE_KEY and the base URL from MAPLE_BASE, as set up in the Quickstart.

Parameters

holdId string path required

Responses

200 OK

object string required

Always booking_hold.released.
id string required
released boolean required

Always true.

Errors

400 Bad request DeveloperApiBadRequest
401 Unauthorized DeveloperApiUnauthorized
403 Forbidden DeveloperApiForbidden
404 Not found DeveloperApiNotFound
409 Conflict DeveloperApiConflict
422 Unprocessable DeveloperApiUnprocessable
429 Too many requests DeveloperApiRateLimited

Every error body names the error in _tag, explains it in message, and says where to report it in feedback. See Errors.

A 429 also sends Retry-After: Seconds to wait before retrying; also returned as retry_after in the body.

Release a hold

curl -X DELETE "$MAPLE_BASE/booking_holds/HOLD_ID" \
  -H "Authorization: Bearer $MAPLE_KEY"

import os
import requests

r = requests.delete(
    f"{os.environ['MAPLE_BASE']}/booking_holds/HOLD_ID",
    headers={"Authorization": f"Bearer {os.environ['MAPLE_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

const res = await fetch(`${process.env.MAPLE_BASE}/booking_holds/HOLD_ID`, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.MAPLE_KEY}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

{
  "object": "booking_hold.released",
  "id": "string",
  "released": true
}

{
  "_tag": "DeveloperApiBadRequest",
  "code": "string",
  "message": "string",
  "feedback": "string"
}