Skip to main content
POST
Cancel Booking

Overview

This endpoint soft-deletes a previously recorded booking. Use the id returned by Create Booking. The bot will stop seeing this booking in its context from the next message onwards.
Authentication: All requests require a Bearer token in the Authorization header.

Important Notes

  • Authentication: All requests require a Bearer token in the Authorization header
  • Idempotency: Re-cancelling an already-cancelled booking is a no-op
  • Access Control: You can only cancel bookings owned by your organization

Getting Your API Key

API keys can be generated from your Setter AI dashboard under Settings > API Keys. Keep your API key secure and never expose it in client-side code.

Example Usage

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

id
integer
required

Booking id returned by Create Booking.

Response

Cancelled

id
integer
Example:

555

event_id
integer
Example:

999

cancelled_at
string<date-time>
Example:

"2026-05-20T17:42:00.000Z"