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

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

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

Удалить один или несколько отдельных биомаркеров из индивидуального набора записи.

Набор биомаркеров после удаления проверяется по правилам замкнутости каждой лаборатории: удаление
может оставить набор неполным (например, если убрать LDL, оставив соотношение LDL/HDL). В этом
случае запрос возвращает `400` со структурированными вариантами исправления, и ничего не удаляется.
Структуру данных `validation` см. в [Добавить отдельные
биомаркеры](https://docs.anivahealth.com/ru/api/appointments/add-individual-biomarkers.md).

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

Требуется scope `appointments_schedule` или `appointments_manage`, а также `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Биомаркеры нельзя удалить после вызова [Подтвердить забор
> крови](https://docs.anivahealth.com/ru/api/appointments/confirm-blood-draw.md).

## Запрос

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

**id** `string` *required*

Уникальный идентификатор (UUID) записи.

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

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

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

## Ответ

**success** `boolean`

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

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

Удаление никогда не возвращает `biomarker_not_priced`. Цена маркера не зависит от остальной части
набора. Набор, в котором уже есть маркер без цены, остаётся доступным для редактирования. См.
[Добавить отдельные биомаркеры](https://docs.anivahealth.com/ru/api/appointments/add-individual-biomarkers.md).

| Статус | Описание |
| - | - |
| `400` | `biomarker_ids` пустой или содержит нецелые числа, набор после удаления не проходит проверку замкнутости (`validation.failures`) или удаление оставило бы биомаркер, который продаётся только в составе позиции (`error: "biomarker_requires_position"`). |
| `403` | Доступ запрещён — отсутствует нужный scope или запись находится вне контекста доступа. |
| `404` | Запись не найдена. |
| `409` | Конфликт — биомаркеры нельзя изменять после подтверждения забора крови. |
| `500` | Внутренняя ошибка сервера. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/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": "Appointment not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.