API reference/POST /public/booking-proposals/{public_proposal_access_token}/withdraw

POST /public/booking-proposals/{public_proposal_access_token}/withdraw

publicoptional rc

Withdraw a pending public booking proposal.

Only pending public requests can be withdrawn by the requester. Booked requests are not cancelled through this endpoint.

Request

POST /public/booking-proposals/{public_proposal_access_token}/withdraw HTTP/1.1

Returns 200 OK with the response body below.

200 OK · example

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "withdrawn",
  "updated_at": "2026-07-04T12:05:00.000Z"
}

Code	Description
`404`	Calendar owner or booking id not found.
`409`	Conflict — the requested slot was already committed at higher priority. Inspect alternatives[] in the response body.
`429`	Rate limit exceeded. Per-key limits: POST /v1/availability/search → 300 req/min; POST /v1/holds, POST /v1/bookings, and /v1/bookings/{hold_id}/confirm → 120 req/min each. A global fallback of 600 req/min per IP applies to all other endpoints. Read the Retry-After header for the exact backoff in seconds.