Skip to main content
POST
Cancel a booking

Authorizations

Authorization
string
header
required

Company-scoped API key. Production keys are prefixed sk_live_, sandbox keys sk_test_, each followed by 22 base62 characters (pattern ^sk_(live|test)_[0-9A-Za-z]{22}$). Generate keys in the TapTalent dashboard under Account Settings → Developers → API Key Management; a key is shown once at generation and old keys are invalidated immediately on regeneration.

Path Parameters

bookingId
integer
required

Body

application/json
reason
string | null

Optional free-text cancellation reason, stored on the booking's activity log.

Response

Booking cancelled.

status
string
required
Allowed value: "success"
data
object
required

A single scheduled appointment, created when a candidate books a slot on a booking link.