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

# Ta bort enskilda biomarkörer

> Ta bort enskilda biomarkörer från en beställning av hemtestkit

Ta bort en eller flera enskilda biomarkörer från en befintlig beställning av hemtestkit. Borttagningen är idempotent: biomarkörer som inte är kopplade ignoreras i stället för att avvisas. Se [Idempotens](https://docs.anivahealth.com/sv/concepts/idempotency.md).

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 tas bort medan kitet har status `pending`. När kitet har status `dispatched` är dess
> sammansättning 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, kontakta Aniva direkt – det går oftast fortfarande att ordna, och
> vi gör ändringen åt dig så att kitets innehåll stämmer.

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Unik identifierare (UUID) för hemtestkitbeställningen som biomarkörer ska tas bort från.

### Body-parametrar

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

Array med biomarköridentifierare att ta bort från hemtestkitbeställningen. Måste innehålla minst ett objekt.

## Svar

Vid framgång returnerar API:et `200 OK` som bekräftar att biomarkörerna har tagits bort.

**success** `boolean`

`true` när biomarkörerna har tagits bort från hemtestkitbeställningen.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel — t.ex. är `biomarker_ids` 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 hemtestkitbeställningen utanför ditt behörighetsomfång. |
| `404` | Hemtestkitbeställningen hittades inte. |
| `409` | Konflikt — kitet är `dispatched`, `activated` eller `cancelled`; dess panel- och biomarkörssammansättning är låst och kan inte längre ändras. |
| `409` | Konflikt — det här är de enda markörerna som ett ersättningskit analyserar om; om du tar bort dem finns inget kvar att beställa. |
| `500` | Internt serverfel. |

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