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

# Удалить отдельные биомаркеры

> Удалить отдельные биомаркеры из заказа набора для домашнего теста

Удали один или несколько отдельных биомаркеров из существующего заказа набора для домашнего теста. Удаление идемпотентно: не прикреплённые биомаркеры игнорируются, а не вызывают ошибку. См. [Идемпотентность](https://docs.anivahealth.com/ru/concepts/idempotency.md).

Требуется право доступа `home_kit_orders_manage`, а также дополнительное право доступа
`home_kit_orders_individual_biomarker_selection`. Наборы для домашнего теста заказываются по панелям,
поэтому отдельные маркеры включаются отдельно для каждого партнёра. Обратись в Aniva, если это нужно твоей интеграции.

> [!WARNING]
>
> Биомаркеры можно удалить только пока набор находится в статусе `pending`. После того как набор получает статус `dispatched`, его
> состав фиксируется, и этот запрос возвращает `409 Conflict` — физический набор отправляется с фиксированным
> количеством пробирок в зависимости от выбранных панелей и биомаркеров, поэтому его состав нельзя изменить
> после отправки. Наборы со статусом `activated` и `cancelled` также заблокированы. Если тебе нужно
> изменить тесты в заблокированном наборе, обратись напрямую в Aniva — обычно это всё ещё возможно, и
> мы внесём изменения за тебя, чтобы состав набора оставался согласованным.

## Запрос

### Параметры пути

**id** `string` *required*

Уникальный идентификатор (UUID) заказа набора для домашнего теста, из которого нужно удалить биомаркеры.

### Параметры тела запроса

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

Массив идентификаторов биомаркеров для удаления из заказа набора для домашнего теста. Должен содержать хотя бы один элемент.

## Ответ

В случае успеха API возвращает `200 OK` с подтверждением удаления биомаркеров.

**success** `boolean`

`true`, если биомаркеры успешно удалены из заказа набора для домашнего теста.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `400` | Ошибка валидации — например, массив `biomarker_ids` пуст или содержит недопустимое значение. |
| `403` | Доступ запрещён — отсутствует scope `home_kit_orders_manage` или scope возможностей `home_kit_orders_individual_biomarker_selection`, либо заказ набора для домашнего теста находится вне области твоих прав доступа. |
| `404` | Заказ набора для домашнего теста не найден. |
| `409` | Конфликт — набор находится в статусе `dispatched`, `activated` или `cancelled`; его панель и состав биомаркеров зафиксированы и больше не могут меняться. |
| `409` | Конфликт — это единственные маркеры, которые повторно проверяет заменяющий набор; их удаление оставит заказ пустым. |
| `500` | Внутренняя ошибка сервера. |

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