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

# Lägg till enskilda biomarkörer

> Lägg till enskilda biomarkörer i en beställning av hemtestkit

Lägg till en eller flera enskilda biomarkörer i en befintlig beställning av hemtestkit, utanför en färdig panel. Den här endpointen är idempotent – biomarkörer som redan är kopplade behålls.

Kräver scopet `home_kit_orders_manage` samt
funktionsscopet `home_kit_orders_individual_biomarker_selection`. Hemtestkit beställs per panel,
så enskilda markörer aktiveras per partner. Fråga Aniva om din integration behöver det.

> [!WARNING]
>
> Biomarkörer kan bara läggas till medan kitet har status `pending`. När kitet är `dispatched` är
> sammansättningen låst och det här anropet returnerar `409 Conflict` – det fysiska kitet skickas
> med ett fast antal provrör baserat på valda paneler och biomarkörer, så innehållet kan inte ändras
> efter att det har skickats. Kit med status `activated` och `cancelled` är också låsta. Om du
> behöver ändra testerna i ett låst kit, hör av dig direkt till Aniva – det går oftast fortfarande
> att ordna, och vi gör ändringen åt dig så att kitets innehåll förblir konsekvent.

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Unik identifierare (UUID) för beställningen av hemtestkit som biomarkörer ska läggas till i.

### Body-parametrar

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

Array med biomarköridentifierare som ska läggas till i beställningen av hemtestkit. Måste
innehålla minst ett element. Använd [Lista biomarkörer](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md) med
`home_kit=true` för att hitta biomarkör-ID:n.

## Svar

När anropet lyckas returnerar API:et `200 OK` som bekräftar att biomarkörerna har lagts till.

**success** `boolean`

`true` när biomarkörerna har lagts till i beställningen av hemtestkit.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel – t.ex. om `biomarker_ids` är tom eller innehåller ett ogiltigt värde. |
| `403` | Åtkomst nekad – saknar `home_kit_orders_manage` eller funktionsscopet `home_kit_orders_individual_biomarker_selection`, eller så ligger beställningen av hemtestkit utanför ditt behörighetsområde. |
| `404` | Beställningen av hemtestkit eller en eller flera biomarkörer hittades inte. |
| `409` | Konflikt – kitet är `dispatched`, `activated` eller `cancelled`; dess sammansättning av panel och biomarkörer är låst och kan inte längre ändras. |
| `500` | Internt serverfel. |

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