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

# Opdater tid

> Ændr detaljer for en tid før blodprøvetagning

Opdater detaljer for en tid, såsom det planlagte tidspunkt eller teststedet. Kun tider, hvor blodprøvetagningen endnu ikke er blevet bekræftet, kan ændres.

> [!WARNING]
>
> Tider kan ikke ændres, efter blodprøvetagningen er blevet bekræftet, eller hvis de allerede er aflyst.
> Forsøg på at opdatere en sådan tid returnerer `409 Conflict`. Den eneste undtagelse er
> `results_ready_emails`, som du stadig kan ændre efter blodprøvetagningen.

Kræver scope `appointments_schedule` eller `appointments_manage`.

## Forespørgsel

### Stiparametre

**id** `string` *required*

Unik identifikator (UUID) for den tid, der skal opdateres.

### Body-parametre

Alle body-parametre er valgfri — inkluder kun de felter, du vil ændre.

**scheduled\_at** `string`

Ny dato og klokkeslæt for tiden i ISO 8601-format (f.eks. `2026-05-20T14:00:00Z` eller
`2026-05-20T16:00:00+02:00`). **Skal indeholde en tidszoneangivelse** — enten `Z` eller en eksplicit
forskydning som `+02:00`; tidspunkter uden tidszone afvises. Skal ligge i fremtiden.

Skal være den nøjagtige start på et tidsrum med ledig kapacitet — se
[Hent ledige tider](https://docs.anivahealth.com/da/api/locations/get-availability.md). Den tid, der flyttes, tæller aldrig
med i kapaciteten for det ønskede tidsrum, men hvis den flyttes til et tidsrum, hvor den samme profil allerede har en *anden*
tid, returneres `409` med den tids `appointment_id`.

Hvis det *nye* sted drives af Aniva, skal det nye tidspunkt også ligge mindst 12 timer fremme — se
[Minimumsvarsel](https://docs.anivahealth.com/da/api/appointments/create-appointment.md#minimumsvarsel).

**location\_id** `string`

UUID for det nye teststed. Stedet skal eksistere og være aktivt. Brug [Vis
steder](https://docs.anivahealth.com/da/api/locations/list-locations.md) til at finde tilgængelige sted-ID'er.

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

Erstatter listen med op til 5 adresser, som hver får én e-mail, når alle laboratorieresultater er endelige.
Send `[]` for at slå e-mails fra. Dette felt kan stadig redigeres efter blodprøvetagningen; kun en aflyst
tid afviser det. Efter blodprøvetagningen skal det sendes alene: med `scheduled_at` eller
`location_id` i samme body returnerer anmodningen `409`. Din nøgle skal have `results_view`-adgang til patienten, ellers `403`. Se
[E-mails, når resultaterne er klar](https://docs.anivahealth.com/da/concepts/results.md#e-mails-nar-resultater-er-klar).

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

Ny metode til blodprøvetagning: `capillary` eller `venous`, eller `null` for at bruge stedets `default_draw_method`
igen. Stedet skal have metoden i sin `draw_methods`, og de bookede prøver skal
kunne udføres med den, ellers `400`. Når du flytter en tid til et andet sted, kører det samme tjek
dér: på dens egen `draw_method`, ellers på det nye steds `default_draw_method`.

## Svar

Ved succes returnerer API'et `200 OK` med den opdaterede tid og dens indlejrede profil.

**id** `string` *required*

Unikt id for tiden (UUID).

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

UUID for den profil, denne tid tilhører.

**location\_id** `string`

UUID for det teststed, hvor blodprøvetagningen finder sted.

**scheduled\_at** `string`

Planlagt dato og klokkeslæt for tiden som et UTC-tidspunkt (ISO 8601 med `Z`-suffiks, f.eks.
`2026-05-20T14:00:00Z`). Kan være `null`.

**status** `string` *required*

Aktuel status for tiden. En af `pending`, `confirmed`, `blood_drawn` eller `cancelled`.
Fremdriften i laboratorieresultaterne udledes fra [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md);
mere detaljeret forsendelsesfremdrift fra hvert element i det indlejrede `shipments`-array (se nedenfor)
videre til [Hent forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Fritekstårsag registreret ved aflysning af tiden (f.eks. udeblivelse, sen aflysning,
'Failed. Repeat required'). `null`, medmindre `status` er `cancelled`.

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

Adresser med små bogstaver, som hver modtager én e-mail, når alle laboratorieresultater er endelige. Tom, når funktionen er slået fra. Se
[E-mails når resultater er klar](https://docs.anivahealth.com/da/concepts/results.md#e-mails-nar-resultater-er-klar).

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

Hvordan blodet tages: `capillary` (fingerspids eller overarm i mikrorør) eller `venous` (fra venen
i prøveglas). Det er den metode, tiden angiver, ellers `default_draw_method` for dens
[lokation](https://docs.anivahealth.com/da/concepts/locations.md). Efter blodprøvetagningen er det den metode, der blev brugt.

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

ISO 8601-tidsstempel for, hvornår tiden blev oprettet.

**updated\_at** `string`

ISO 8601-tidsstempel for den seneste opdatering. Kan være `null`.

**profile** `object` *required*

Den patientprofil, der er knyttet til denne tid.

**Profil**

**id** `string`

Unikt id for profilen (UUID).

**handle** `string`

Profil-handle eller brugernavn. Kan være `null`.

**first\_name** `string`

Fornavn. Kan være `null`.

**last\_name** `string`

Efternavn. Kan være `null`.

**email** `string`

E-mailadresse. Kan være `null`.

**phone** `string`

Telefonnummer i E.164-format. Kan være `null`.

**sex** `integer`

Biologisk køn efter ISO/IEC 5218. Kan være `null`.

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

Fødselsdato i formatet `YYYY-MM-DD`. Kan være `null`.

**height** `number`

Højde i centimeter. Kan være `null`.

**weight** `number`

Vægt i kilogram. Kan være `null`.

**language** `string`

Foretrukket sprog: en af de 32 koder i [Opret profil](https://docs.anivahealth.com/da/api/profiles/create-profile.md).

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

Om denne profil modtager transaktionelle (programmatiske) e-mails. Kan være `null`.

**created\_at** `string`

ISO 8601-tidsstempel for, hvornår profilen blev oprettet.

**updated\_at** `string`

ISO 8601-tidsstempel for den seneste opdatering af profilen. Kan være `null`.

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

Paneler, der i øjeblikket er tilknyttet denne tid. Inkluderer ikke annullerede tilknytninger. Slå
paneldetaljer (navn, biomarkører) op via [Vis paneler](https://docs.anivahealth.com/da/api/panels/list-panels.md).

**Felter for tilknyttet panel**

**panel\_id** `string`

Panelets UUID — krydsreferer med [Vis paneler](https://docs.anivahealth.com/da/api/panels/list-panels.md).

**added\_at** `string`

ISO 8601-tidsstempel for, hvornår panelet første gang blev knyttet til denne tid.

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

À la carte-biomarkører knyttet til denne tid uden for et panel (se [Tilføj valgfrie
biomarkører](https://docs.anivahealth.com/da/api/appointments/add-individual-biomarkers.md)). Krydsreferer hvert `biomarker_id`
med [Vis biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md) for visningsdata.

**Felter for individuel biomarkør**

**biomarker\_id** `integer`

Biomarkør-id — krydsreferer med
[Vis biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

ISO 8601-tidsstempel for, hvornår biomarkøren første gang blev knyttet til denne tid.

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

Forsendelser knyttet til denne tid, ældste tilknytning først. Tomt array, når ingen forsendelser er
tilknyttet. Slå hvert `id` op med [Hent forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md) for hele
forsendelsens payload.

**Felter for forsendelseslink**

**id** `string`

Forsendelsens reference-id — krydsreferer med
[Hent forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md).

**added\_at** `string`

ISO 8601-tidsstempel for, hvornår forsendelsen første gang blev knyttet til denne tid.

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

Laboratoriekoder (stregkoder på prøveglas) registreret for denne tid i scanningsrækkefølge. Tom, indtil blodprøvetagningen
er bekræftet. En venøs blodprøvetagning har én kode trykt på hvert prøveglas; en kapillær blodprøvetagning har én
kode pr. mikrorør. Resultater og dokumenter i [Hent resultater](https://docs.anivahealth.com/da/api/appointments/get-results.md) henviser
til disse koder via `lab_code`.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfejl — f.eks. ligger `scheduled_at` i fortiden eller under 12 timer fremme på en Aniva-drevet lokation, ugyldigt UUID-format, lokationen har ikke beholdere til `draw_method`, eller de bookede tests er ikke mulige med `draw_method`. |
| `403` | Forbudt — din API-nøgle har ikke adgang til denne handling, tiden eller lokationen ligger uden for din adgangskontekst, eller `results_ready_emails` er sat uden `results_view`-adgang til patienten. |
| `404` | Tid eller lokation blev ikke fundet. |
| `409` | Tiden kan ikke ændres (blodprøvetagningen er allerede bekræftet, eller tiden er aflyst), det ønskede tidsrum er fyldt, lokationen er lukket på den dato, eller denne profil har allerede en anden tid på den valgte lokation og det valgte tidspunkt (indeholder `appointment_id`). |
| `500` | Intern serverfejl. |

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