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

# Adaugă biomarkeri individuali

> Adaugă biomarkeri individuali la o comandă de kit de testare la domiciliu

Adaugă unul sau mai mulți biomarkeri individuali la o comandă de kit de testare la domiciliu existentă, în afara unui panel predefinit. Acest endpoint este idempotent — biomarkerii deja atașați sunt păstrați.

Necesită scope-ul `home_kit_orders_manage` plus scope-ul de capabilitate
`home_kit_orders_individual_biomarker_selection`. Kiturile de testare la domiciliu se comandă pe panel,
așa că markerii individuali sunt activați pentru fiecare partener. Întreabă Aniva dacă integrarea ta are nevoie de asta.

> [!WARNING]
>
> Biomarkerii pot fi adăugați doar cât timp kitul este `pending`. Odată ce kitul este `dispatched`,
> compoziția lui este blocată și acest apel returnează `409 Conflict` — kitul fizic este expediat cu un număr fix
> de tuburi, stabilit pe baza panelurilor și biomarkerilor selectați, deci conținutul lui nu se mai poate schimba
> după ce a fost trimis. Kiturile `activated` și `cancelled` sunt de asemenea blocate. Dacă trebuie să
> schimbi testele unui kit blocat, contactează direct Aniva — de obicei este încă posibil, iar
> noi vom face modificarea pentru tine ca să păstrăm conținutul kitului consecvent.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al comenzii de kit de testare la domiciliu la care adaugi biomarkeri.

### Parametri de corp

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

Listă de identificatori de biomarkeri de adăugat la comanda de kit de testare la domiciliu. Trebuie să conțină cel puțin un element. Folosește
[Listează biomarkerii](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) cu `home_kit=true` pentru a afla ID-urile biomarkerilor.

## Răspuns

La succes, API-ul returnează `200 OK`, confirmând că biomarkerii au fost adăugați.

**success** `boolean`

`true` atunci când biomarkerii au fost adăugați cu succes la comanda de kit de testare la domiciliu.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Eroare de validare — de ex., `biomarker_ids` este gol sau conține o valoare invalidă. |
| `403` | Interzis — lipsește scope-ul `home_kit_orders_manage` sau scope-ul de capabilitate `home_kit_orders_individual_biomarker_selection`, ori comanda de kit de testare la domiciliu nu intră în domeniul tău de permisiuni. |
| `404` | Comanda de kit de testare la domiciliu sau unul ori mai mulți biomarkeri nu au fost găsiți. |
| `409` | Conflict — kitul este `dispatched`, `activated` sau `cancelled`; compoziția lui de paneluri și biomarkeri este blocată și nu se mai poate schimba. |
| `500` | Eroare internă de server. |

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