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

# Pievienot atsevišķus biomarķierus

> Pievienot atsevišķus biomarķierus mājas testa komplekta pasūtījumam

Pievieno vienu vai vairākus atsevišķi izvēlētus biomarķierus esošam mājas testa komplekta pasūtījumam ārpus jebkura gatava paneļa. Šis galapunkts ir idempotents — jau pievienotie biomarķieri tiek saglabāti.

Nepieciešams `home_kit_orders_manage` tvērums, kā arī
`home_kit_orders_individual_biomarker_selection` iespēju tvērums. Mājas testa komplekti tiek pasūtīti pa paneļiem,
tāpēc atsevišķi marķieri tiek iespējoti katram partnerim individuāli. Jautā Aniva, ja tavai integrācijai tas ir nepieciešams.

> [!WARNING]
>
> Biomarķierus var pievienot tikai tad, kamēr komplekts ir `pending` statusā. Tiklīdz komplekts ir `dispatched` statusā, tā
> sastāvs ir bloķēts un šis izsaukums atgriež `409 Conflict` — fiziskais komplekts tiek nosūtīts ar fiksētu
> stobriņu skaitu atbilstoši izvēlētajiem paneļiem un biomarķieriem, tāpēc tā saturu nevar mainīt
> pēc nosūtīšanas. Tāpat ir bloķēti `activated` un `cancelled` komplekti. Ja tev jāmaina
> analīzes bloķētam komplektam, sazinies ar Aniva tieši — parasti tas joprojām ir iespējams, un
> mēs veiksim izmaiņas tavā vietā, lai komplekta saturs paliktu saskaņots.

## Pieprasījums

### Ceļa parametri

**id** `string` *required*

Mājas testa komplekta pasūtījuma unikālais identifikators (UUID), kuram pievienot biomarķierus.

### Pieprasījuma satura parametri

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

Biomarķieru identifikatoru masīvs, ko pievienot mājas testa komplekta pasūtījumam. Jāsatur vismaz viens elements. Izmanto
[Uzskaitīt biomarķierus](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md) ar `home_kit=true`, lai atrastu biomarķieru ID.

## Atbilde

Veiksmīgas izpildes gadījumā API atgriež `200 OK`, apstiprinot, ka biomarķieri ir pievienoti.

**success** `boolean`

`true`, kad biomarķieri ir veiksmīgi pievienoti mājas testa komplekta pasūtījumam.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Validācijas kļūda — piemēram, `biomarker_ids` ir tukšs vai satur nederīgu vērtību. |
| `403` | Aizliegts — trūkst `home_kit_orders_manage` vai `home_kit_orders_individual_biomarker_selection` iespēju tvēruma, vai mājas testa komplekta pasūtījums ir ārpus tava atļauju tvēruma. |
| `404` | Mājas testa komplekta pasūtījums vai viens vai vairāki biomarķieri nav atrasti. |
| `409` | Konflikts — komplekts ir `dispatched`, `activated` vai `cancelled` statusā; tā paneļu un biomarķieru sastāvs ir bloķēts un vairs nevar mainīties. |
| `500` | Iekšēja servera kļūda. |

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