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

# Odebrat jednotlivé biomarkery

> Odebrat jednotlivé biomarkery z objednávky domácí testovací sady

Odeber jeden nebo více samostatných biomarkerů z existující objednávky domácí testovací sady. Odebrání je idempotentní: biomarkery, které nejsou přiřazené, se ignorují místo toho, aby se požadavek zamítl. Viz [Idempotence](https://docs.anivahealth.com/cs/concepts/idempotency.md).

Vyžaduje scope `home_kit_orders_manage` a doplňkový scope
`home_kit_orders_individual_biomarker_selection`. Domácí testovací sady se objednávají po panelech,
takže jednotlivé markery jsou povoleny pro každého partnera zvlášť. Kontaktuj Aniva, pokud to tvá integrace potřebuje.

> [!WARNING]
>
> Biomarkery lze odebrat jen dokud je sada ve stavu `pending`. Jakmile je sada ve stavu `dispatched`,
> její složení je uzamčené a toto volání vrátí `409 Conflict` — fyzická sada se posílá s pevným
> počtem zkumavek podle vybraných panelů a biomarkerů, takže po odeslání už její obsah nejde
> změnit. Sady ve stavu `activated` a `cancelled` jsou uzamčené stejně tak. Pokud potřebuješ
> změnit testy u uzamčené sady, ozvi se přímo týmu Aniva — většinou je to pořád možné a
> změnu uděláme za tebe, aby obsah sady zůstal konzistentní.

## Požadavek

### Parametry cesty

**id** `string` *required*

Jedinečný identifikátor (UUID) objednávky domácí testovací sady, ze které chceš odebrat biomarkery.

### Parametry těla

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

Pole identifikátorů biomarkerů, které chceš z objednávky domácí testovací sady odebrat. Musí obsahovat alespoň jednu položku.

## Odpověď

Při úspěchu API vrátí `200 OK` jako potvrzení, že biomarkery byly odebrány.

**success** `boolean`

`true`, když byly biomarkery z objednávky domácí testovací sady úspěšně odebrány.

## Chybové odpovědi

| Status | Popis |
| - | - |
| `400` | Chyba validace – např. `biomarker_ids` je prázdné nebo obsahuje neplatnou hodnotu. |
| `403` | Přístup odepřen – chybí scope `home_kit_orders_manage` nebo scope funkce `home_kit_orders_individual_biomarker_selection`, případně je objednávka domácí testovací sady mimo rozsah tvých oprávnění. |
| `404` | Objednávka domácí testovací sady nebyla nalezena. |
| `409` | Konflikt – sada je ve stavu `dispatched`, `activated` nebo `cancelled`; její panel a složení biomarkerů jsou uzamčené a už je nelze změnit. |
| `409` | Konflikt – jde o jediné markery, které náhradní sada opakuje; jejich odebráním by nezbylo nic k objednání. |
| `500` | Interní chyba serveru. |

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