> ## 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 a la carta de un pedido de kit de prueba en casa

Elimina uno o más biomarcadores a la carta de un pedido de kit de prueba en casa existente. 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 `home_kit_orders_manage` y el
scope de capacidad `home_kit_orders_individual_biomarker_selection`. Los kits de prueba en casa se piden por panel,
así que los marcadores individuales se activan por socio. Pregunta a Aniva si tu integración lo necesita.

> [!WARNING]
>
> Solo se pueden eliminar biomarcadores mientras el kit está en `pending`. Una vez que el kit está en `dispatched`, su
> composición queda bloqueada y esta llamada devuelve `409 Conflict` — el kit físico se envía con un número
> fijo de tubos según los paneles y biomarcadores seleccionados, por lo que su contenido no puede cambiar
> después del envío. Los kits en `activated` y `cancelled` también están bloqueados. Si necesitas
> cambiar las pruebas de un kit bloqueado, ponte en contacto directamente con Aniva — suele ser posible y
> haremos el cambio por ti para mantener la coherencia del contenido del kit.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) del pedido de kit de prueba en casa del que quieres eliminar biomarcadores.

### Parámetros del cuerpo

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

Array de identificadores de biomarcadores para eliminar del pedido de kit de prueba en casa. Debe contener al menos un elemento.

## Respuesta

Si tiene éxito, la API devuelve `200 OK` confirmando que se han eliminado los biomarcadores.

**success** `boolean`

`true` cuando los biomarcadores se han eliminado correctamente del pedido de kit de prueba en casa.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Error de validación — p. ej., `biomarker_ids` está vacío o contiene un valor no válido. |
| `403` | Prohibido — falta `home_kit_orders_manage` o el alcance de capacidad `home_kit_orders_individual_biomarker_selection`, o el pedido de kit de prueba en casa está fuera de tu alcance de permisos. |
| `404` | Pedido de kit de prueba en casa no encontrado. |
| `409` | Conflicto — el kit está en estado `dispatched`, `activated` o `cancelled`; su panel y su composición de biomarcadores están bloqueados y ya no se pueden cambiar. |
| `409` | Conflicto — son los únicos marcadores que vuelve a analizar un kit de sustitución; eliminarlos no dejaría nada que pedir. |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/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": "Home kit order not found"
}
```


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