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

# Actualizează programarea

> Modifică detaliile programării înainte de recoltarea de sânge

Actualizează detaliile programării, cum ar fi ora programată sau locația de testare. Doar programările pentru care recoltarea de sânge nu a fost încă confirmată pot fi modificate.

> [!WARNING]
>
> Programările nu pot fi modificate după ce recoltarea de sânge a fost confirmată sau dacă sunt
> deja anulate. Încercarea de a actualiza o astfel de programare returnează `409 Conflict`. Singura
> excepție este `results_ready_emails`, pe care îl poți modifica în continuare după recoltarea de
> sânge.

Necesită scope-ul `appointments_schedule` sau `appointments_manage`.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al programării de actualizat.

### Parametri de corp

Toți parametrii din body sunt opționali — include doar câmpurile pe care vrei să le modifici.

**scheduled\_at** `string`

Noua dată și oră a programării în format ISO 8601 (de ex., `2026-05-20T14:00:00Z` sau
`2026-05-20T16:00:00+02:00`). **Trebuie să includă un indicator de fus orar** — fie `Z`, fie un
decalaj explicit precum `+02:00`; valorile fără fus orar sunt respinse. Trebuie să fie în viitor.

Trebuie să fie exact ora de început a unui interval cu capacitate disponibilă — vezi
[Obține disponibilitatea](https://docs.anivahealth.com/ro/api/locations/get-availability.md). Programarea reprogramată nu se contorizează
niciodată în propriul interval țintă, dar mutarea într-un interval în care același profil are deja o
*altă* programare returnează `409` cu `appointment_id` al acelei programări.

Dacă locația *țintă* este operată de Aniva, noua oră trebuie să fie și cu cel puțin 12 ore în
avans — vezi [Preaviz minim](https://docs.anivahealth.com/ro/api/appointments/create-appointment.md#preaviz-minim).

**location\_id** `string`

UUID-ul noii locații de testare. Locația trebuie să existe și să fie activă. Folosește [Listează
locațiile](https://docs.anivahealth.com/ro/api/locations/list-locations.md) pentru a găsi ID-urile locațiilor disponibile.

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

Înlocuiește lista de până la 5 adrese care primesc fiecare câte un e-mail odată ce toate
rezultatele de laborator sunt finale. Trimite `[]` pentru a dezactiva e-mailurile. Acest câmp
rămâne editabil după recoltarea de sânge; doar o programare anulată îl respinge. După recoltarea
de sânge, trimite-l singur: cu `scheduled_at` sau `location_id` în același body, cererea
returnează `409`. Cheia ta are nevoie de acces `results_view` pentru pacient, altfel primești
`403`. Vezi [E-mailuri pentru rezultate gata](https://docs.anivahealth.com/ro/concepts/results.md#e-mailuri-cand-rezultatele-sunt-gata).

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

Noua metodă de recoltare: `capillary` sau `venous`, ori `null` pentru a folosi din nou
`default_draw_method` al locației. Locația trebuie să includă metoda în `draw_methods`, iar
analizele programate trebuie să fie posibile cu aceasta, altfel primești `400`. Când muți o
programare la o altă locație, aceeași verificare rulează acolo: pe propriul `draw_method` sau, în
lipsa lui, pe `default_draw_method` al noii locații.

## Răspuns

În caz de succes, API-ul returnează `200 OK` cu programarea actualizată și profilul integrat al acesteia.

**id** `string` *required*

Identificatorul unic al programării (UUID).

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

UUID-ul profilului căruia îi aparține această programare.

**location\_id** `string`

UUID-ul locației de testare unde are loc recoltarea de sânge.

**scheduled\_at** `string`

Data și ora programării ca moment UTC (ISO 8601 cu sufixul `Z`, de ex.
`2026-05-20T14:00:00Z`). Poate fi `null`.

**status** `string` *required*

Statusul curent al programării. Una dintre valorile `pending`, `confirmed`, `blood_drawn` sau `cancelled`.
Detaliile privind finalizarea rezultatelor de laborator se obțin din [Obține rezultatele](https://docs.anivahealth.com/ro/api/appointments/get-results.md);
evoluția detaliată a expedierii se obține din fiecare intrare din lista inline `shipments` (vezi mai jos),
urmată de [Obține expedierea](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Motivul în text liber înregistrat la anularea programării (de ex. neprezentare, anulare tardivă,
„Eșuat. Necesită repetare”). Este `null` dacă `status` nu este `cancelled`.

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

Adresele care primesc fiecare câte un e-mail când toate rezultatele de laborator sunt finale, cu
litere mici. Gol când este dezactivat. Vezi
[E-mailuri pentru rezultate gata](https://docs.anivahealth.com/ro/concepts/results.md#e-mailuri-cand-rezultatele-sunt-gata).

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

Cum se face recoltarea de sânge: `capillary` (din vârful degetului sau partea superioară a brațului, în
microtainere) sau `venous` (din venă, în eprubete). Este metoda setată pe programare sau
`default_draw_method` al [locației](https://docs.anivahealth.com/ro/concepts/locations.md) acesteia. După recoltarea de sânge, este
metoda care a fost folosită.

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

Timestamp ISO 8601 al creării programării.

**updated\_at** `string`

Timestamp ISO 8601 al ultimei actualizări. Poate fi `null`.

**profile** `object` *required*

Profilul pacientului asociat cu această programare.

**profil**

**id** `string`

Identificatorul unic al profilului (UUID).

**handle** `string`

Handle-ul profilului sau numele de utilizator. Poate fi `null`.

**first\_name** `string`

Prenume. Poate fi `null`.

**last\_name** `string`

Nume de familie. Poate fi `null`.

**email** `string`

Adresă de e-mail. Poate fi `null`.

**phone** `string`

Număr de telefon în format E.164. Poate fi `null`.

**sex** `integer`

Sex biologic conform ISO/IEC 5218. Poate fi `null`.

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

Data nașterii în format `YYYY-MM-DD`. Poate fi `null`.

**height** `number`

Înălțime în centimetri. Poate fi `null`.

**weight** `number`

Greutate în kilograme. Poate fi `null`.

**language** `string`

Limba preferată: unul dintre cele 32 de coduri din [Creează profil](https://docs.anivahealth.com/ro/api/profiles/create-profile.md).

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

Indică dacă acest profil primește e-mailuri tranzacționale (programatice). Poate fi `null`.

**created\_at** `string`

Timestamp ISO 8601 al creării profilului.

**updated\_at** `string`

Timestamp ISO 8601 al ultimei actualizări a profilului. Poate fi `null`.

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

Panelurile atașate în prezent acestei programări. Exclude atașările anulate. Consultă detaliile
panelului (nume, biomarkeri) prin [Listează panelurile](https://docs.anivahealth.com/ro/api/panels/list-panels.md).

**Câmpurile panelului asociat**

**panel\_id** `string`

UUID-ul panelului — corelează cu [Listează paneluri](https://docs.anivahealth.com/ro/api/panels/list-panels.md).

**added\_at** `string`

Timestamp ISO 8601 al primei asocieri a panelului cu această programare.

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

Biomarkeri à la carte asociați cu această programare în afara unui panel (vezi [Adaugă biomarkeri
personalizați](https://docs.anivahealth.com/ro/api/appointments/add-individual-biomarkers.md)). Corelează fiecare `biomarker_id`
cu [Listează biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) pentru datele de afișare.

**Câmpurile biomarkerului individual**

**biomarker\_id** `integer`

Identificatorul biomarkerului — corelează cu
[Listează biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

Timestamp ISO 8601 al primei asocieri a biomarkerului cu această programare.

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

Expedierile asociate acestei programări, în ordinea celei mai vechi asocieri. Array gol când nu
există expedieri asociate. Corelează fiecare `id` cu [Obține expedierea](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md)
pentru payload-ul complet al expedierii.

**Câmpurile expedierii asociate**

**id** `string`

Identificatorul de referință al expedierii — corelează cu
[Obține expediere](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md).

**added\_at** `string`

Timestamp ISO 8601 al primei asocieri a expedierii cu această programare.

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

Codurile de laborator (codurile de bare de pe eprubete) înregistrate pentru această programare, în
ordinea scanării. Gol până la confirmarea recoltării de sânge. O recoltare venoasă are un singur
cod tipărit pe fiecare eprubetă; o recoltare capilară are câte un cod per microtainer. Rezultatele
și documentele din [Obține rezultate](https://docs.anivahealth.com/ro/api/appointments/get-results.md) fac referire la aceste coduri
prin `lab_code`.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Eroare de validare — de ex., `scheduled_at` este în trecut, este la mai puțin de 12 ore distanță într-o locație operată de Aniva, format UUID nevalid, locația nu are pe stoc recipiente pentru `draw_method` sau testele programate nu sunt posibile cu `draw_method`. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune, programarea sau locația se află în afara contextului tău de acces sau `results_ready_emails` este setat fără acces `results_view` la pacient. |
| `404` | Programarea sau locația nu a fost găsită. |
| `409` | Programarea nu poate fi modificată (recoltarea de sânge este deja confirmată sau programarea este anulată), intervalul ales a atins capacitatea maximă, locația este închisă la acea dată sau acest profil are deja o altă programare la locația și ora alese (include `appointment_id`). |
| `500` | Eroare internă de server. |

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