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

# Atjaunināt pierakstu

> Mainīt pieraksta informāciju pirms asins paņemšanas

Atjaunini pieraksta informāciju, piemēram, ieplānoto laiku vai analīžu veikšanas vietu. Mainīt var tikai tos pierakstus, kuriem vēl nav apstiprināta asins paņemšana.

> [!WARNING]
>
> Pierakstus nevar mainīt pēc asins paņemšanas apstiprināšanas vai tad, ja tie jau ir atcelti.
> Mēģinot atjaunināt šādu pierakstu, tiek atgriezts `409 Conflict`. Vienīgais izņēmums ir
> `results_ready_emails`, ko joprojām vari mainīt pēc asins paņemšanas.

Nepieciešama `appointments_schedule` vai `appointments_manage` piekļuves joma.

## Pieprasījums

### Ceļa parametri

**id** `string` *required*

Atjaunināmā pieraksta unikālais identifikators (UUID).

### Pieprasījuma satura parametri

Visi pamatteksta parametri ir neobligāti — iekļauj tikai tos laukus, kurus vēlies mainīt.

**scheduled\_at** `string`

Jaunais pieraksta datums un laiks ISO 8601 formātā (piemēram, `2026-05-20T14:00:00Z` vai
`2026-05-20T16:00:00+02:00`). **Jāiekļauj laika joslas apzīmējums** — vai nu `Z`, vai tieši
norādīta nobīde, piemēram, `+02:00`; datumi un laiki bez laika joslas tiek noraidīti. Jābūt
nākotnē.

Jābūt precīzam laika loga sākumam ar brīvām vietām — skati
[Iegūt pieejamību](https://docs.anivahealth.com/lv/api/locations/get-availability.md). Pārplānotais pieraksts nekad netiek ieskaitīts
savā mērķa laika logā, bet pārcelšana uz laika logu, kurā tam pašam profilam jau ir *cits*
pieraksts, atgriež `409` ar šī pieraksta `appointment_id`.

Ja *mērķa* atrašanās vietu pārvalda Aniva, jaunajam laikam jābūt arī vismaz pēc 12 stundām — skati
[Minimālais pieteikšanas laiks](https://docs.anivahealth.com/lv/api/appointments/create-appointment.md#minimalais-pieteiksanas-laiks).

**location\_id** `string`

Jaunās analīžu veikšanas vietas UUID. Atrašanās vietai jāpastāv un jābūt aktīvai. Izmanto [Atrašanās
vietu saraksts](https://docs.anivahealth.com/lv/api/locations/list-locations.md), lai atrastu pieejamos atrašanās vietu ID.

**results\_ready\_emails** `string[]`

Aizstāj sarakstu ar līdz 5 adresēm, no kurām katra saņem vienu e-pastu, tiklīdz visi laboratorijas
rezultāti ir galīgi. Nosūti `[]`, lai izslēgtu e-pastus. Šis lauks paliek rediģējams pēc asins
paņemšanas; to noraida tikai atcelts pieraksts. Pēc asins paņemšanas nosūti to vienu pašu: ja tajā
pašā pamattekstā ir `scheduled_at` vai `location_id`, pieprasījums atgriež `409`. Tavai atslēgai
nepieciešama `results_view` piekļuve pacientam, pretējā gadījumā — `403`. Skati
[E-pasti par gataviem rezultātiem](https://docs.anivahealth.com/lv/concepts/results.md#e-pasti-par-gataviem-rezultatiem).

**draw\_method** `string | null`

Jaunā asins paņemšanas metode: `capillary` vai `venous`, vai `null`, lai atkal izmantotu atrašanās
vietas `default_draw_method`. Atrašanās vietai šī metode jāiekļauj savā `draw_methods` sarakstā,
un pieteiktajām analīzēm jābūt iespējamām ar šo metodi, pretējā gadījumā — `400`. Kad pārcel
pierakstu uz citu atrašanās vietu, tur notiek tāda pati pārbaude: pieraksta `draw_method`, pretējā
gadījumā — jaunās atrašanās vietas `default_draw_method`.

## Atbilde

Veiksmīgas izpildes gadījumā API atgriež `200 OK` ar atjaunināto pierakstu un tajā iekļauto profilu.

**id** `string` *required*

Unikāls pieraksta identifikators (UUID).

**profile\_id** `string` *required*

Profila UUID, kuram pieder šis pieraksts.

**location\_id** `string`

Analīžu vietas UUID, kur notiek asins paņemšana.

**scheduled\_at** `string`

Ieplānotais pieraksta datums un laiks UTC laikā (ISO 8601 ar `Z` sufiksu, piemēram,
`2026-05-20T14:00:00Z`). Var būt `null`.

**status** `string` *required*

Pašreizējais pieraksta statuss. Viens no: `pending`, `confirmed`, `blood_drawn` vai `cancelled`.
Detalizētu laboratorijas rezultātu gatavības informāciju var iegūt ar
[Iegūt rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md); detalizētāku sūtījuma gaitu — no katra ieraksta
iebūvētajā `shipments` masīvā (skati zemāk), tālāk izmantojot
[Iegūt sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Brīva teksta iemesls, kas fiksēts pieraksta atcelšanas brīdī (piem., neierašanās, vēla atcelšana,
'Neizdevās. Nepieciešams atkārtot'). Ir `null`, ja vien `status` nav `cancelled`.

**results\_ready\_emails** `string[]` *required*

Adreses mazajiem burtiem, no kurām katra saņem vienu e-pastu, tiklīdz visi laboratorijas rezultāti ir galīgi. Tukšs, kad izslēgts. Skatīt
[E-pasti par gataviem rezultātiem](https://docs.anivahealth.com/lv/concepts/results.md#e-pasti-par-gataviem-rezultatiem).

**draw\_method** `string` *required*

Asins paņemšanas metode: `capillary` (no pirksta gala vai augšdelma mikrostobriņos) vai `venous` (no vēnas
stobriņos). Tā ir metode, ko nosaka pieraksts, vai arī tā [vietas](https://docs.anivahealth.com/lv/concepts/locations.md) `default_draw_method`.
Pēc asins paņemšanas tā ir izmantotā metode.

**created\_at** `string` *required*

ISO 8601 laikspiedols, kad pieraksts tika izveidots.

**updated\_at** `string`

Pēdējā atjauninājuma ISO 8601 laikspiedols. Var būt `null`.

**profile** `object` *required*

Ar šo pierakstu saistītais pacienta profils.

**profils**

**id** `string`

Unikāls profila identifikators (UUID).

**handle** `string`

Profila segvārds vai lietotājvārds. Var būt `null`.

**first\_name** `string`

Vārds. Var būt `null`.

**last\_name** `string`

Uzvārds. Var būt `null`.

**email** `string`

E-pasta adrese. Var būt `null`.

**phone** `string`

Tālruņa numurs E.164 formātā. Var būt `null`.

**sex** `integer`

Bioloģiskais dzimums saskaņā ar ISO/IEC 5218. Var būt `null`.

**date\_of\_birth** `string`

Dzimšanas datums formātā `YYYY-MM-DD`. Var būt `null`.

**height** `number`

Augums centimetros. Var būt `null`.

**weight** `number`

Svars kilogramos. Var būt `null`.

**language** `string`

Vēlamā valoda: viens no 32 kodiem sadaļā [Izveidot profilu](https://docs.anivahealth.com/lv/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Vai šis profils saņem darījumu (programmatiskos) e-pastus. Var būt `null`.

**created\_at** `string`

ISO 8601 laikspiedols, kad profils tika izveidots.

**updated\_at** `string`

Pēdējā profila atjauninājuma ISO 8601 laikspiedols. Var būt `null`.

**panels** `AppointmentPanel[]` *required*

Paneļi, kas pašlaik ir pievienoti šim pierakstam. Neietver atceltos pievienojumus. Skati paneļa
informāciju (nosaukumu, biomarķierus), izmantojot [Skatīt paneļus](https://docs.anivahealth.com/lv/api/panels/list-panels.md).

**Paneļa piesaistes lauki**

**panel\_id** `string`

Paneļa UUID — salīdzini ar [Paneļu saraksts](https://docs.anivahealth.com/lv/api/panels/list-panels.md).

**added\_at** `string`

ISO 8601 laikspiedols, kad panelis pirmo reizi tika piesaistīts šim pierakstam.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

Individuālie biomarķieri, kas piesaistīti šim pierakstam ārpus jebkura paneļa (sk. [Pievienot pielāgotus
biomarķierus](https://docs.anivahealth.com/lv/api/appointments/add-individual-biomarkers.md)). Salīdzini katru `biomarker_id`
ar [Biomarķieru saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md), lai iegūtu attēlošanas datus.

**Individuālo biomarķieru lauki**

**biomarker\_id** `integer`

Biomarķiera identifikators — salīdzini ar
[Biomarķieru saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

ISO 8601 laikspiedols, kad biomarķieris pirmo reizi tika piesaistīts šim pierakstam.

**shipments** `AppointmentShipmentLink[]` *required*

Ar šo pierakstu saistītie sūtījumi, sākot ar vecāko saiti. Tukšs masīvs, ja nav saistītu sūtījumu.
Izmanto katru `id` pieprasījumā [Iegūt sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md), lai iegūtu pilnus
sūtījuma datus.

**Sūtījuma saites lauki**

**id** `string`

Sūtījuma atsauces identifikators — salīdzini ar
[Iegūt sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md).

**added\_at** `string`

ISO 8601 laikspiedols, kad sūtījums pirmo reizi tika piesaistīts šim pierakstam.

**lab\_codes** `string[]` *required*

Šim pierakstam reģistrētie laboratorijas kodi (stobriņu svītrkodi) skenēšanas secībā. Tukšs, līdz asins paņemšana
ir apstiprināta. Venozai asins paņemšanai ir viens kods, kas uzdrukāts uz katra stobriņa; kapilārai asins paņemšanai ir viens
kods katram mikrostobriņam. Rezultāti un dokumenti sadaļā [Iegūt rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md) atsaucas
uz šiem kodiem ar `lab_code`.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Validācijas kļūda — piemēram, `scheduled_at` ir pagātnē, ir mazāk nekā pēc 12 stundām Aniva pārvaldītā atrašanās vietā, nederīgs UUID formāts, atrašanās vietā nav trauciņu izvēlētajai `draw_method` metodei vai pieteiktās analīzes nav iespējamas ar šo `draw_method`. |
| `403` | Aizliegts — tavai API atslēgai nav piekļuves šai darbībai, pieraksts vai atrašanās vieta ir ārpus tava piekļuves konteksta vai `results_ready_emails` ir iestatīts bez `results_view` piekļuves pacientam. |
| `404` | Pieraksts vai atrašanās vieta nav atrasta. |
| `409` | Pierakstu nevar mainīt (asins paņemšana jau ir apstiprināta vai pieraksts ir atcelts), izvēlētais laiks ir pilns, atrašanās vieta tajā datumā ir slēgta vai šim profilam jau ir cits pieraksts izvēlētajā atrašanās vietā un laikā (ietver `appointment_id`). |
| `500` | Iekšēja servera kļūda. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "scheduled_at": "2026-05-20T14:00:00Z",
    "location_id": "d8f3e1a2-4c5b-6d7e-8f9a-0b1c2d3e4f5a"
  }'
```

```json 200 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "d8f3e1a2-4c5b-6d7e-8f9a-0b1c2d3e4f5a",
  "scheduled_at": "2026-05-20T14:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": "2026-04-10T11:30:00Z",
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:50:00Z"
    }
  ],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

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

```json 404 theme={null}
{
  "error": "Location not found or inactive"
}
```


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