> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar cita

> Modificar los detalles de la cita antes de la extracción de sangre

Actualiza los datos de una cita, como la hora programada o la ubicación del análisis. Solo se pueden modificar las citas cuya extracción de sangre aún no se ha confirmado.

> [!WARNING]
>
> No se pueden modificar citas después de confirmar la extracción de sangre ni si ya están canceladas.
> Intentar actualizar una cita en ese estado devuelve `409 Conflict`. La única excepción es
> `results_ready_emails`, que puedes seguir cambiando después de la extracción de sangre.

Requiere el scope `appointments_schedule` o `appointments_manage`.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) de la cita que se va a actualizar.

### Parámetros del cuerpo

Todos los parámetros del cuerpo son opcionales — incluye solo los campos que quieras cambiar.

**scheduled\_at** `string`

Nueva fecha y hora de la cita en formato ISO 8601 (por ejemplo, `2026-05-20T14:00:00Z` o
`2026-05-20T16:00:00+02:00`). **Debe incluir un indicador de zona horaria** — ya sea `Z` o un desplazamiento
explícito como `+02:00`; se rechazan las fechas y horas sin zona horaria. Debe ser futura.

Debe coincidir con el inicio exacto de una franja con capacidad disponible — consulta
[Obtener disponibilidad](https://docs.anivahealth.com/es/api/locations/get-availability.md). La cita que se reprograma nunca resta
capacidad a su propia franja de destino, pero moverla a una franja donde el mismo perfil ya tiene una cita
*distinta* devuelve `409` con el `appointment_id` de esa cita.

Si la ubicación de *destino* está operada por Aniva, la nueva hora también debe tener al menos 12 horas de antelación — consulta
[Antelación mínima](https://docs.anivahealth.com/es/api/appointments/create-appointment.md#antelacion-minima).

**location\_id** `string`

UUID de la nueva ubicación del análisis. La ubicación debe existir y estar activa. Usa [Listar
ubicaciones](https://docs.anivahealth.com/es/api/locations/list-locations.md) para encontrar los ID de ubicaciones disponibles.

**results\_ready\_emails** `string[]`

Sustituye la lista de hasta 5 direcciones que reciben un correo cada una cuando todos los resultados de laboratorio son definitivos.
Envía `[]` para desactivar estos correos. Este campo sigue siendo editable después de la extracción de sangre; solo se rechaza si la cita
está cancelada. Después de la extracción de sangre, envíalo solo: si incluyes `scheduled_at` o
`location_id` en el mismo cuerpo, la solicitud devuelve `409`. Tu clave necesita acceso `results_view` al paciente; de lo contrario, devuelve `403`. Consulta
[Correos de resultados listos](https://docs.anivahealth.com/es/concepts/results.md#correos-de-resultados-listos).

**draw\_method** `string | null`

Nuevo método de extracción: `capillary` o `venous`, o `null` para volver a usar el `default_draw_method` de la
ubicación. La ubicación debe incluir el método en su campo `draw_methods` y las pruebas reservadas deben
poder realizarse con él; de lo contrario, devuelve `400`. Cuando mueves una cita a otra ubicación, se ejecuta allí la misma
comprobación: sobre su propio `draw_method` o, si no tiene, sobre el `default_draw_method` de la nueva ubicación.

## Respuesta

Si la operación tiene éxito, la API devuelve `200 OK` con la cita actualizada y su perfil integrado.

**id** `string` *required*

Identificador único de la cita (UUID).

**profile\_id** `string` *required*

UUID del perfil al que pertenece esta cita.

**location\_id** `string`

UUID del centro de análisis donde se realiza la extracción de sangre.

**scheduled\_at** `string`

Fecha y hora programada de la cita como instante UTC (ISO 8601 con sufijo `Z`, por ejemplo,
`2026-05-20T14:00:00Z`). Puede ser `null`.

**status** `string` *required*

Estado actual de la cita. Puede ser `pending`, `confirmed`, `blood_drawn` o `cancelled`. El grado
de avance de los resultados de laboratorio se obtiene en [Obtener resultados](https://docs.anivahealth.com/es/api/appointments/get-results.md);
el progreso detallado de los envíos, a partir de cada entrada del array `shipments` integrado (ver
más abajo) consultándolo en [Obtener envío](https://docs.anivahealth.com/es/api/shipments/get-shipment.md).

**cancellation\_reason** `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`.

**results\_ready\_emails** `string[]` *required*

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](https://docs.anivahealth.com/es/concepts/results.md#correos-de-resultados-listos).

**draw\_method** `string` *required*

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](https://docs.anivahealth.com/es/concepts/locations.md). Después de la extracción de sangre, es el método que se utilizó.

**created\_at** `string` *required*

Marca de tiempo ISO 8601 de cuándo se creó la cita.

**updated\_at** `string`

Marca de tiempo ISO 8601 de la última actualización. Puede ser `null`.

**profile** `object` *required*

El perfil del paciente asociado a esta cita.

**perfil**

**id** `string`

Identificador único del perfil (UUID).

**handle** `string`

Alias o nombre de usuario del perfil. Puede ser `null`.

**first\_name** `string`

Nombre. Puede ser `null`.

**last\_name** `string`

Apellido. Puede ser `null`.

**email** `string`

Dirección de correo electrónico. Puede ser `null`.

**phone** `string`

Número de teléfono en formato E.164. Puede ser `null`.

**sex** `integer`

Sexo biológico según ISO/IEC 5218. Puede ser `null`.

**date\_of\_birth** `string`

Fecha de nacimiento en formato `YYYY-MM-DD`. Puede ser `null`.

**height** `number`

Altura en centímetros. Puede ser `null`.

**weight** `number`

Peso en kilogramos. Puede ser `null`.

**language** `string`

Idioma preferido: uno de los 32 códigos en [Crear perfil](https://docs.anivahealth.com/es/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Indica si este perfil recibe correos transaccionales (programáticos). Puede ser `null`.

**created\_at** `string`

Marca de tiempo ISO 8601 de cuándo se creó el perfil.

**updated\_at** `string`

Marca de tiempo ISO 8601 de la última actualización del perfil. Puede ser `null`.

**panels** `AppointmentPanel[]` *required*

Paneles asociados actualmente a esta cita. Excluye las asociaciones canceladas. Consulta los detalles
del panel (nombre, biomarcadores) mediante [Listar paneles](https://docs.anivahealth.com/es/api/panels/list-panels.md).

**Campos de asociación de panel**

**panel\_id** `string`

UUID del panel: contrástalo con [Listar paneles](https://docs.anivahealth.com/es/api/panels/list-panels.md).

**added\_at** `string`

Marca de tiempo ISO 8601 en la que el panel se asoció por primera vez a esta cita.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

Biomarcadores a la carta asociados a esta cita fuera de cualquier panel (consulta [Añadir
biomarcadores personalizados](https://docs.anivahealth.com/es/api/appointments/add-individual-biomarkers.md)). Contrasta cada `biomarker_id`
con [Listar biomarcadores](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md) para obtener los datos de visualización.

**Campos de biomarcador individual**

**biomarker\_id** `integer`

Identificador del biomarcador: contrástalo con
[Listar biomarcadores](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

Marca de tiempo ISO 8601 en la que el biomarcador se asoció por primera vez a esta cita.

**shipments** `AppointmentShipmentLink[]` *required*

Envíos vinculados a esta cita, ordenados del vínculo más antiguo al más reciente. Array vacío cuando no hay envíos
vinculados. Consulta cada `id` en [Obtener envío](https://docs.anivahealth.com/es/api/shipments/get-shipment.md) para ver el
payload completo del envío.

**Campos de vínculo de envío**

**id** `string`

Identificador de referencia del envío: contrástalo con
[Obtener envío](https://docs.anivahealth.com/es/api/shipments/get-shipment.md).

**added\_at** `string`

Marca de tiempo ISO 8601 en la que el envío se vinculó por primera vez a esta cita.

**lab\_codes** `string[]` *required*

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](https://docs.anivahealth.com/es/api/appointments/get-results.md) hacen referencia
a estos códigos mediante `lab_code`.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Error de validación — p. ej., `scheduled_at` está en el pasado, faltan menos de 12 horas en un centro gestionado por Aniva, formato de UUID no válido, el centro no dispone de recipientes para el `draw_method` o las pruebas reservadas no son posibles con el `draw_method`. |
| `403` | Prohibido — tu clave de API no tiene acceso a esta operación, la cita o el centro están fuera de tu contexto de acceso, o `results_ready_emails` está configurado sin acceso `results_view` al paciente. |
| `404` | Cita o centro no encontrado. |
| `409` | La cita no se puede modificar (la extracción de sangre ya está confirmada o la cita está cancelada), la franja de destino está completa, el centro está cerrado en esa fecha o este perfil ya tiene otra cita en el centro y la hora de destino (incluye `appointment_id`). |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "scheduled_at": "2026-05-20T14:00:00Z",
    "location_id": "d8f3e1a2-4c5b-6d7e-8f9a-0b1c2d3e4f5a"
  }'
```

```json 200 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "d8f3e1a2-4c5b-6d7e-8f9a-0b1c2d3e4f5a",
  "scheduled_at": "2026-05-20T14:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": "2026-04-10T11:30:00Z",
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:50:00Z"
    }
  ],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

```json 409 theme={null}
{
  "error": "Appointment cannot be modified after blood draw has been confirmed"
}
```

```json 404 theme={null}
{
  "error": "Location not found or inactive"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.