Skip to main content
POST
Confirmar una cita
Moves the appointment from pending to confirmed. The call reads the current appointment first and rejects with 409 if the state isn’t pending (you can’t confirm an appointment that’s already confirmed, completed, or cancelled).

Endpoint

Required scope

scheduling:appointments:confirm

Path params

Headers

No body required.

Example request

Response

200 OK

Returns the appointment with status: "confirmed". Shape identical to the body of GET /appointments/:id.

409 Conflict

404 Not Found

The appointment doesn’t exist or belongs to another company.

401 Unauthorized · 403 Forbidden

Same semantics as the rest of the public API.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Response

200 - application/json
_id
string
required

Id de la cita

branch
object
required
dates
object
required
status
string
required

pending | confirmed | cancelled | …

appointment_number
number

Correlativo legible de la cita

service
object
professional
object
customer
object
appointment_type
string

online | in-person

payment_status
string

Estado del pago

notes
string
price
number
currency
string

Moneda ISO 4217

paid
boolean
cancelled_at
string<date-time>
cancellation_reason
string
created_at
string<date-time>
updated_at
string<date-time>