> ## 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.

# Eliminar biomarcadores individuales

> Eliminar biomarcadores individuales de una cita

Elimina uno o más biomarcadores individuales del conjunto a la carta de una cita.

El conjunto de biomarcadores tras la eliminación se valida según las reglas de cierre de cada laboratorio: una eliminación puede
dejar el conjunto incompleto (por ejemplo, quitar el LDL manteniendo el ratio LDL/HDL). Cuando ocurre, la solicitud
devuelve `400` con opciones de recuperación estructuradas y no se elimina nada. Consulta [Añadir biomarcadores
individuales](https://docs.anivahealth.com/es/api/appointments/add-individual-biomarkers.md) para ver la estructura del payload `validation`.

La eliminación es idempotente: los biomarcadores que no están asociados se ignoran en lugar de rechazarse. Consulta [Idempotencia](https://docs.anivahealth.com/es/concepts/idempotency.md).

Requiere el scope `appointments_schedule` o `appointments_manage`, además de `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> No se pueden eliminar biomarcadores después de llamar a [Confirmar extracción de
> sangre](https://docs.anivahealth.com/es/api/appointments/confirm-blood-draw.md).

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) de la cita.

### Parámetros del cuerpo

**biomarker\_ids** `number[]` *required*

Array de ID de biomarcadores que se van a desvincular. Debe contener al menos un elemento. Cualquier ID que no esté en la
cita se ignora.

## Respuesta

**success** `boolean`

`true` cuando los biomarcadores se han eliminado correctamente.

## Respuestas de error

La eliminación nunca devuelve `biomarker_not_priced`. El precio de un marcador no depende del resto
del conjunto. Un conjunto que ya contiene un marcador sin precio sigue siendo editable. Consulta [Añadir biomarcadores
individuales](https://docs.anivahealth.com/es/api/appointments/add-individual-biomarkers.md).

| Estado | Descripción |
| - | - |
| `400` | `biomarker_ids` está vacío o no contiene enteros, el conjunto tras la eliminación no supera la validación de cierre (`validation.failures`) o la eliminación dejaría suelto un biomarcador que solo se vende dentro de una posición (`error: "biomarker_requires_position"`). |
| `403` | Prohibido — falta un scope o la cita está fuera del contexto de acceso. |
| `404` | Cita no encontrada. |
| `409` | Conflicto — no se pueden modificar los biomarcadores después de confirmar la extracción de sangre. |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/biomarkers \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [42]
  }'
```

```json 200 theme={null}
{
  "success": true
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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