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

# Uppdatera bokning

> Ändra bokningsuppgifter före blodprovstagningen

Uppdatera bokningsuppgifter som bokad tid eller provtagningsplats. Bara bokningar vars blodprovstagning ännu inte har bekräftats kan ändras.

> [!WARNING]
>
> Bokningar kan inte ändras efter att blodprovstagningen har bekräftats eller om de redan har
> avbokats. Försök att uppdatera en sådan bokning returnerar `409 Conflict`. Det enda undantaget är
> `results_ready_emails`, som du fortfarande kan ändra efter blodprovstagningen.

Kräver scopet `appointments_schedule` eller `appointments_manage`.

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Unik identifierare (UUID) för bokningen som ska uppdateras.

### Body-parametrar

Alla body-parametrar är valfria – ta bara med de fält du vill ändra.

**scheduled\_at** `string`

Nytt datum och tid för bokningen i ISO 8601-format (t.ex. `2026-05-20T14:00:00Z` eller
`2026-05-20T16:00:00+02:00`). **Måste innehålla en tidszonsangivelse** – antingen `Z` eller en
explicit tidsförskjutning som `+02:00`; naiva tidsangivelser avvisas. Måste ligga i framtiden.

Måste vara en exakt starttid för en tidslucka med ledig kapacitet – se
[Hämta tillgänglighet](https://docs.anivahealth.com/sv/api/locations/get-availability.md). Bokningen som ombokas räknas aldrig mot
sin egen nya tidslucka, men om den flyttas till en tidslucka där samma profil redan har en *annan*
bokning returneras `409` med den bokningens `appointment_id`.

Om den *nya* platsen drivs av Aniva måste den nya tiden också ligga minst 12 timmar framåt i
tiden – se [Minsta framförhållning](https://docs.anivahealth.com/sv/api/appointments/create-appointment.md#minsta-framfoerhallning).

**location\_id** `string`

UUID för den nya provtagningsplatsen. Platsen måste finnas och vara aktiv. Använd [Lista
platser](https://docs.anivahealth.com/sv/api/locations/list-locations.md) för att hitta tillgängliga plats-ID:n.

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

Ersätter listan med upp till 5 adresser som var och en får ett mejl när alla labbresultat är
slutgiltiga. Skicka `[]` för att stänga av mejlen. Det här fältet förblir redigerbart efter
blodprovstagningen; bara en avbokad bokning avvisar det. Efter blodprovstagningen skickar du det
ensamt: med `scheduled_at` eller `location_id` i samma body returnerar anropet `409`. Din nyckel
behöver `results_view`-åtkomst till patienten, annars returneras `403`. Se
[Mejl när resultat är klara](https://docs.anivahealth.com/sv/concepts/results.md#mejl-naer-resultat-aer-klara).

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

Ny provtagningsmetod: `capillary` eller `venous`, eller `null` för att använda platsens
`default_draw_method` igen. Platsen måste lista metoden i `draw_methods`, och de bokade proven
måste gå att ta med den, annars returneras `400`. När du flyttar en bokning till en annan plats
körs samma kontroll där: på bokningens egen `draw_method`, annars på den nya platsens
`default_draw_method`.

## Svar

Om anropet lyckas returnerar API:et `200 OK` med den uppdaterade bokningen och dess inbäddade profil.

**id** `string` *required*

Unik identifierare för bokningen (UUID).

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

UUID för den profil som bokningen tillhör.

**location\_id** `string`

UUID för provtagningsstället där blodprovstagningen sker.

**scheduled\_at** `string`

Bokat datum och tid som en UTC-tidpunkt (ISO 8601 med `Z`-suffix, t.ex.
`2026-05-20T14:00:00Z`). Kan vara `null`.

**status** `string` *required*

Aktuell bokningsstatus. Något av `pending`, `confirmed`, `blood_drawn` eller `cancelled`.
Detaljerad status för färdigställda labbresultat får du från [Hämta resultat](https://docs.anivahealth.com/sv/api/appointments/get-results.md);
mer detaljerad försändelsestatus från varje post i `shipments`-arrayen nedan vidare till [Hämta
försändelse](https://docs.anivahealth.com/sv/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Orsak i fritext som registrerades när bokningen avbokades (t.ex. uteblivet besök, sen avbokning,
'Misslyckades. Behöver göras om'). `null` om inte `status` är `cancelled`.

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

Adresser som var och en får ett mejl när alla labbresultat är slutgiltiga, i gemener. Tom när funktionen är avstängd. Se
[Mejl när resultat är klara](https://docs.anivahealth.com/sv/concepts/results.md#mejl-naer-resultat-aer-klara).

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

Hur blodet tas: `capillary` (fingertopp eller överarm, i mikrorör) eller `venous` (från ven,
i provrör). Det är metoden som bokningen anger, annars `default_draw_method` för dess
[provtagningsställe](https://docs.anivahealth.com/sv/concepts/locations.md). Efter blodprovstagningen är det den metod som användes.

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

ISO 8601-tidsstämpel för när bokningen skapades.

**updated\_at** `string`

ISO 8601-tidsstämpel för den senaste uppdateringen. Kan vara `null`.

**profile** `object` *required*

Patientprofilen som är kopplad till den här bokningen.

**profil**

**id** `string`

Unik identifierare för profilen (UUID).

**handle** `string`

Profil-handle eller användarnamn. Kan vara `null`.

**first\_name** `string`

Förnamn. Kan vara `null`.

**last\_name** `string`

Efternamn. Kan vara `null`.

**email** `string`

E-postadress. Kan vara `null`.

**phone** `string`

Telefonnummer i E.164-format. Kan vara `null`.

**sex** `integer`

Biologiskt kön enligt ISO/IEC 5218. Kan vara `null`.

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

Födelsedatum i formatet `YYYY-MM-DD`. Kan vara `null`.

**height** `number`

Längd i centimeter. Kan vara `null`.

**weight** `number`

Vikt i kilogram. Kan vara `null`.

**language** `string`

Föredraget språk: en av de 32 koderna i [Skapa profil](https://docs.anivahealth.com/sv/api/profiles/create-profile.md).

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

Om profilen tar emot transaktionella (programmatiska) mejl. Kan vara `null`.

**created\_at** `string`

ISO 8601-tidsstämpel för när profilen skapades.

**updated\_at** `string`

ISO 8601-tidsstämpel för den senaste uppdateringen av profilen. Kan vara `null`.

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

Paneler som för närvarande är kopplade till den här bokningen. Exkluderar avbrutna kopplingar. Slå upp
paneldetaljer (namn, biomarkörer) via [Lista paneler](https://docs.anivahealth.com/sv/api/panels/list-panels.md).

**Fält för kopplade paneler**

**panel\_id** `string`

Panelens UUID — korsreferera mot [Lista paneler](https://docs.anivahealth.com/sv/api/panels/list-panels.md).

**added\_at** `string`

ISO 8601-tidsstämpel för när panelen först kopplades till bokningen.

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

Enskilda biomarkörer som är kopplade till den här bokningen utanför någon panel (se [Lägg till anpassade
biomarkörer](https://docs.anivahealth.com/sv/api/appointments/add-individual-biomarkers.md)). Korsreferera varje `biomarker_id`
mot [Lista biomarkörer](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md) för visningsdata.

**Fält för enskilda biomarkörer**

**biomarker\_id** `integer`

Identifierare för biomarkören — korsreferera mot
[Lista biomarkörer](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

ISO 8601-tidsstämpel för när biomarkören först kopplades till bokningen.

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

Försändelser kopplade till den här bokningen, äldsta kopplingen först. Tom array när inga
försändelser är kopplade. Korsreferera varje `id` mot [Hämta
försändelse](https://docs.anivahealth.com/sv/api/shipments/get-shipment.md) för fullständig försändelsedata.

**Fält för försändelselänkar**

**id** `string`

Referensidentifierare för försändelsen — korsreferera mot
[Hämta försändelse](https://docs.anivahealth.com/sv/api/shipments/get-shipment.md).

**added\_at** `string`

ISO 8601-tidsstämpel för när försändelsen först länkades till bokningen.

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

Labbkoder (rörens streckkoder) som registrerats för den här bokningen, i skanningsordning. Tom tills blodprovstagningen
är bekräftad. En venös blodprovstagning har en kod tryckt på varje provrör; en kapillär blodprovstagning har en
kod per mikrorör. Resultat och dokument i [Hämta resultat](https://docs.anivahealth.com/sv/api/appointments/get-results.md) refererar till
dessa koder via `lab_code`.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel — t.ex. ligger `scheduled_at` i det förflutna, är mindre än 12 timmar framåt på en plats som drivs av Aniva, ogiltigt UUID-format, platsen har inte provkärl för `draw_method`, eller de bokade testerna är inte möjliga med `draw_method`. |
| `403` | Förbjudet — din API-nyckel har inte behörighet till den här åtgärden, bokningen eller platsen ligger utanför din åtkomstkontext, eller `results_ready_emails` är satt utan `results_view`-åtkomst till patienten. |
| `404` | Bokningen eller platsen hittades inte. |
| `409` | Bokningen kan inte ändras (blodprovstagningen är redan bekräftad eller bokningen är avbokad), den valda tiden är fullbokad, platsen är stängd det datumet, eller profilen har redan en annan bokning på den valda platsen och tiden (innehåller `appointment_id`). |
| `500` | Internt serverfel. |

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