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

# Elimina biomarcadors individuals

> Elimina biomarcadors a la carta d'una comanda de kit de prova a casa

Elimina un o més biomarcadors a la carta d'una comanda de kit de prova a casa existent. L'eliminació és idempotent: els biomarcadors que no hi estan associats s'ignoren en lloc de rebutjar-se. Consulta [Idempotència](https://docs.anivahealth.com/ca/concepts/idempotency.md).

Requereix l'àmbit `home_kit_orders_manage` més l'àmbit de capacitat
`home_kit_orders_individual_biomarker_selection`. Els kits de prova a casa es demanen per panell,
així que els marcadors individuals s'activen per col·laborador. Demana-ho a Aniva si la teva integració ho necessita.

> [!WARNING]
>
> Els biomarcadors només es poden eliminar mentre el kit és `pending`. Quan el kit passa a `dispatched`, la seva
> composició queda bloquejada i aquesta crida retorna `409 Conflict` — el kit físic s'envia amb un nombre
> fix de tubs determinat pels panells i biomarcadors seleccionats, així que el contingut no es pot canviar
> després d'enviar-lo. Els kits `activated` i `cancelled` també estan bloquejats. Si necessites
> canviar les proves d'un kit bloquejat, posa't en contacte directament amb Aniva — normalment encara és possible i
> farem el canvi per tu per mantenir coherent el contingut del kit.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

Identificador únic (UUID) de la comanda de kit de prova a casa de la qual vols eliminar biomarcadors.

### Paràmetres del cos

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

Matriu d'identificadors de biomarcadors per eliminar de la comanda de kit de prova a casa. Ha de contenir almenys un element.

## Resposta

En cas d'èxit, l'API retorna `200 OK` i confirma que s'han eliminat els biomarcadors.

**success** `boolean`

`true` quan els biomarcadors s'han eliminat correctament de la comanda de kit de prova a casa.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Error de validació — p. ex., `biomarker_ids` és buit o conté un valor no vàlid. |
| `403` | Prohibit — falta l'àmbit `home_kit_orders_manage` o l'àmbit de capacitat `home_kit_orders_individual_biomarker_selection`, o la comanda de kit de prova a casa és fora del teu àmbit de permisos. |
| `404` | No s'ha trobat la comanda de kit de prova a casa. |
| `409` | Conflicte — el kit té l'estat `dispatched`, `activated` o `cancelled`; la composició del panell i dels biomarcadors està bloquejada i ja no es pot canviar. |
| `409` | Conflicte — aquests són els únics marcadors que torna a analitzar un kit de substitució; si s'eliminen, no quedaria res per demanar. |
| `500` | Error intern 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.