Suspender (cancelar) una cita
Appointments
POST /v1/scheduling/appointments/:id/cancel
Cancel an appointment with an optional reason. Marks status as cancelled and records cancelled_at.
POST
Suspender (cancelar) una cita
Marks the appointment as cancelled. Persists
Other states (such as
cancelled_at: <now> and cancellation_reason if provided. Freeing the calendar slot is automatic: from this point on the time slot shows up as available again.
Endpoint
Required scope
scheduling:appointments:cancel
Path params
Headers
Body
Example request
Response
200 OK
Returns the appointment withstatus: "cancelled", cancelled_at, and cancellation_reason populated.
404 Not Found
The appointment doesn’t exist or belongs to another company.409 Conflict
completed) also return 409 if they don’t allow cancellation.
401 Unauthorized · 403 Forbidden
Same semantics as the rest of the public API.Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Path Parameters
Body
application/json
Motivo de cancelación
Response
200 - application/json
Id de la cita
pending | confirmed | cancelled | …
Correlativo legible de la cita
online | in-person
Estado del pago
Moneda ISO 4217