Bookings

Cancel a booking

Cancels a booking and deletes its Google Calendar event. The same as Confirm or cancel a booking with status: "cancelled", except that it never stores a reason. Scope: bookings:write. Keys: secret.

DELETE/bookings/{id}cancelBooking

Authorizations

bearerAuthhttp (bearer)

Authorization: Bearer clndr_sk_… (secret) or clndr_pk_… (publishable).

apiKeyHeaderapiKey

The same key in a custom header, for clients that can't set Authorization.

Server

https://www.clndr.pro/api/v1

Production

Path Parameters

idstring<uuid>required

The booking's id.

Example: c3a7e5d1-2b9f-4c6e-8a1d-7f4b0e2c9a58

Responses

200The booking is cancelled.application/json

successbooleanrequired

401The key is missing, unknown, revoked or expired.application/json

errorstringrequired

What went wrong, in plain English.

403The key doesn't have the scope this endpoint needs.application/json

errorstringrequired

What went wrong, in plain English.

404No booking with this id on the key's account.application/json

errorstringrequired

What went wrong, in plain English.

429Too many requests from this key in the current 60-second window.application/json

errorstringrequired

What went wrong, in plain English.

500Something failed on our side. Retry with exponential backoff.application/json

errorstringrequired

What went wrong, in plain English.

curl https://www.clndr.pro/api/v1/bookings/c3a7e5d1-2b9f-4c6e-8a1d-7f4b0e2c9a58 \
  --request DELETE \
  --header 'Authorization: Bearer <token>'

fetch('https://www.clndr.pro/api/v1/bookings/c3a7e5d1-2b9f-4c6e-8a1d-7f4b0e2c9a58', {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer <token>'
  }
})

requests.delete(
    "https://www.clndr.pro/api/v1/bookings/c3a7e5d1-2b9f-4c6e-8a1d-7f4b0e2c9a58",
    headers={
      "Authorization": "Bearer <token>"
    }
)

fetch('https://www.clndr.pro/api/v1/bookings/c3a7e5d1-2b9f-4c6e-8a1d-7f4b0e2c9a58', {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer <token>'
  }
})

{
  "success": true
}

{
  "error": "Missing API key. Send `Authorization: Bearer <key>` or `x-clndr-key` header."
}

{
  "error": "API key is missing required scope(s): bookings:read"
}

{
  "error": "Booking not found"
}

{
  "error": "Rate limit exceeded. This publishable key allows 120 requests per 60s window."
}

{
  "error": "Failed to fetch bookings"
}