Saltar al contenido principal
DELETE
Cancela una cita estableciendo su estado en cancelled. Solo se pueden cancelar las citas cuya extracción de sangre aún no se haya confirmado. Cancelar una cita que ya está en estado cancelled devuelve 200 con esa cita y no escribe nada: no se registra una segunda cancelación. La respuesta incluye Idempotent-Replayed: true para que puedas distinguir una repetición de la llamada que realizó la operación. En cambio, una repetición con un cancellation_reason diferente devuelve 409: el motivo registrado nunca se sobrescribe. Consulta Idempotencia.
No se pueden cancelar citas después de confirmar la extracción de sangre: eso devuelve 409 Conflict.
Requiere el scope appointments_schedule o appointments_manage.

Solicitud

Parámetros de ruta

string
requerido
Identificador único (UUID) de la cita que quieres cancelar.

Parámetros del cuerpo

El cuerpo es opcional: no envíes ningún cuerpo para cancelar sin registrar un motivo.
string
Motivo de cancelación en texto libre, de hasta 500 caracteres (p. ej., Patient no-show). Se guarda en la cita y se devuelve como cancellation_reason en esta y en posteriores lecturas.

Respuesta

Si tiene éxito, la API devuelve 200 OK con la cita cancelada y su perfil incrustado.
string
requerido
Identificador único de la cita (UUID).
string
requerido
UUID del perfil al que pertenece esta cita.
string
UUID del centro de análisis donde se realiza la extracción de sangre.
string
Fecha y hora programadas de la cita como instante UTC (ISO 8601 con sufijo Z, p. ej., 2026-05-15T10:30:00Z). Puede ser null.
string
requerido
Estado de la cita. Será cancelled tras una cancelación correcta.
string
Motivo en texto libre registrado al cancelar la cita (p. ej., no presentado, cancelación tardía, ‘Fallida. Repetición necesaria’). null salvo que status sea cancelled.
string[]
requerido
Direcciones que reciben un correo cada una cuando todos los resultados de laboratorio son definitivos, en minúsculas. Vacío cuando está desactivado. Consulta Correos de resultados listos.
string
requerido
Cómo se realiza la extracción de sangre: capillary (en la yema del dedo o en la parte superior del brazo, en microtubos) o venous (de la vena, en tubos). Es el método definido en la cita o, en su defecto, el default_draw_method de su ubicación. Después de la extracción de sangre, es el método que se utilizó.
string
requerido
Marca de tiempo ISO 8601 de cuándo se creó la cita.
string
Marca de tiempo ISO 8601 de la última actualización. Puede ser null.
object
requerido
El perfil del paciente asociado a esta cita.
AppointmentPanel[]
requerido
Paneles que estaban asociados a esta cita antes de la cancelación. Consulta los detalles del panel (nombre, biomarcadores) mediante Listar paneles.
AppointmentIndividualBiomarker[]
requerido
Biomarcadores a la carta asociados a esta cita fuera de cualquier panel (consulta Añadir biomarcadores personalizados). Contrasta cada biomarker_id con Listar biomarcadores para obtener los datos de visualización.
AppointmentShipmentLink[]
requerido
Envíos que estaban vinculados a esta cita antes de la cancelación. Cada id se puede contrastar con Obtener envío.
string[]
requerido
Códigos de laboratorio (códigos de barras de los tubos) registrados para esta cita, en orden de escaneo. Vacío hasta que se confirme la extracción de sangre. Una extracción venosa lleva un único código impreso en todos los tubos; una extracción capilar lleva un código por microtubo. Los resultados y documentos de Obtener resultados hacen referencia a estos códigos mediante lab_code.

Respuestas de error