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

# Додати панелі

> Додати панелі аналізу крові до запису

Додай одну або кілька панелей аналізу крові до наявного запису. Ти можеш викликати цей ендпойнт кілька разів, щоб сформувати набір панелей до підтвердження забору крові.

Потребує дозволу `appointments_schedule`.

> [!WARNING]
>
> Панелі не можна додавати після виклику [Підтвердити забір крові](https://docs.anivahealth.com/uk/api/appointments/confirm-blood-draw.md).
> Спроба додати панелі до підтвердженого запису повертає `409 Conflict`.

Під час капілярного забору крові (`draw_method: capillary`) зразки розподіляються по мікротейнерах. Спочатку йдуть панелі в
порядку бронювання. Потім окремі біомаркери заповнюють вільний простір мікротейнерів панелей. Коли їм
потрібно більше місця, відкриваються нові мікротейнери. Ми розподіляємо їх рівномірно. Кожен мікротейнер вміщує щонайбільше
150 µl окремих біомаркерів. Якщо отриманий набір панелей порушує це правило, виклик повертає `400` із
повідомленням `error`, і жодна панель не додається.

## Запит

### Параметри шляху

**id** `string` *required*

Унікальний ідентифікатор (UUID) запису, до якого додаються панелі.

### Параметри тіла запиту

**panel\_ids** `string[]` *required*

Масив UUID панелей для додавання до запису. Має містити щонайменше один елемент.

## Відповідь

У разі успіху API повертає `200 OK`, підтверджуючи, що панелі додано.

**success** `boolean`

`true`, коли панелі успішно додано до запису.

## Відповіді з помилками

| Статус | Опис |
| - | - |
| `400` | Помилка валідації — наприклад, `panel_ids` порожній або містить недійсний UUID — або під час капілярного забору крові окремі біомаркери більше не вміщуються у свої мікротейнери. |
| `403` | Заборонено — твій API-ключ не має доступу до цієї операції. |
| `404` | Запис або одну чи кілька панелей не знайдено. |
| `409` | Конфлікт — панелі не можна додавати після підтвердження забору крові або панель є набором для домашнього тесту (`error_name: "home_kit_appointment_mismatch_error"`). Замов набір для домашнього тесту як [замовлення набору для домашнього тесту](https://docs.anivahealth.com/uk/api/home-kit-orders/create-home-kit.md). |
| `500` | Внутрішня помилка сервера. |

### Панель набору для домашнього тесту

Набір для домашнього тесту надсилається пацієнту, і забір крові за ним не проводиться під час запису. Якщо панель у `panel_ids` є
набором для домашнього тесту, виклик повертає `409` і не додає жодної панелі. Тіло відповіді містить такі поля:

**error** `string`

Зрозуміла для людини причина.

**error\_name** `string`

Завжди `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Запис, до якого панель не було додано.

**panel\_id** `string`

Панель набору для домашнього тесту.

**home\_kit\_provider** `string | null`

Постачальник набору для домашнього тесту для панелі або `null`, якщо він невідомий.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/panels \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": [
      "d4e5f6a7-b8c9-4d1e-a2f3-b4c5d6e7f8a9",
      "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
    ]
  }'
```

```json 200 theme={null}
{
  "success": true
}
```

```json 400 (capillary, does not fit) theme={null}
{
  "error": "Some individual biomarkers need more than 150 µl of one lab's microtainer. Remove some of them."
}
```

```json 409 theme={null}
{
  "error": "Panels cannot be added after blood draw has been confirmed"
}
```

```json 409 (home kit panel) theme={null}
{
  "error": "Panel e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0 is a home kit (biomes) and cannot attach to appointment c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a — order it via home-kit orders",
  "error_name": "home_kit_appointment_mismatch_error",
  "appointment_id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "panel_id": "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0",
  "home_kit_provider": "biomes"
}
```

```json 404 theme={null}
{
  "error": "Panels not found: e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
}
```


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