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

# Afegeix biomarcadors individuals

> Afegeix biomarcadors a la carta a una comanda de kit de prova a casa

Afegeix un o més biomarcadors a la carta a una comanda de kit de prova a casa existent, fora de qualsevol panell predefinit. Aquest endpoint és idempotent — els biomarcadors que ja hi són associats es mantenen.

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]
>
> Només es poden afegir biomarcadors mentre el kit està `pending`. Un cop el kit està `dispatched`, la seva
> composició queda bloquejada i aquesta crida retorna `409 Conflict` — el kit físic s'envia amb un nombre fix
> de tubs derivats dels panells i biomarcadors seleccionats, així que el seu contingut no pot canviar
> després d'haver-se enviat. Els kits `activated` i `cancelled` també queden bloquejats. Si necessites
> canviar les proves d'un kit bloquejat, contacta directament amb Aniva — normalment encara és possible, i
> farem el canvi per tu perquè el contingut del kit continuï sent coherent.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

Identificador únic (UUID) de la comanda de kit de prova a casa on afegir biomarcadors.

### Paràmetres del cos

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

Matriu d'identificadors de biomarcadors per afegir a la comanda de kit de prova a casa. Ha de contenir com a mínim un element. Fes servir
[Llista biomarcadors](https://docs.anivahealth.com/ca/api/biomarkers/list-biomarkers.md) amb `home_kit=true` per trobar els ID dels biomarcadors.

## Resposta

Si té èxit, l'API retorna `200 OK` confirmant que s'han afegit els biomarcadors.

**success** `boolean`

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

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Error de validació — p. ex., `biomarker_ids` està 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 queda fora del teu àmbit de permisos. |
| `404` | No s'ha trobat la comanda de kit de prova a casa o un o més biomarcadors. |
| `409` | Conflicte — el kit està `dispatched`, `activated` o `cancelled`; la seva composició de panells i biomarcadors està bloquejada i ja no pot canviar. |
| `500` | Error intern del servidor. |

```bash cURL theme={null}
curl --request PATCH \
  --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, 87]
  }'
```

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

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


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