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

# Oppdater time

> Endre timedetaljer før blodprøvetaking

Oppdater timedetaljer som avtalt tidspunkt eller prøvested. Bare timer der blodprøvetakingen ennå ikke er bekreftet, kan endres.

> [!WARNING]
>
> Timer kan ikke endres etter at blodprøvetakingen er bekreftet eller hvis de allerede er
> avbestilt. Forsøk på å oppdatere en slik time returnerer `409 Conflict`. Det eneste unntaket er
> `results_ready_emails`, som du fortsatt kan endre etter blodprøvetakingen.

Krever tilgangsomfanget `appointments_schedule` eller `appointments_manage`.

## Forespørsel

### Stiparametere

**id** `string` *required*

Unik identifikator (UUID) for timen som skal oppdateres.

### Body-parametere

Alle body-parametere er valgfrie – ta bare med feltene du vil endre.

**scheduled\_at** `string`

Ny dato og nytt klokkeslett for timen i ISO 8601-format (f.eks. `2026-05-20T14:00:00Z` eller
`2026-05-20T16:00:00+02:00`). **Må inneholde en tidssoneangivelse** – enten `Z` eller en
eksplisitt forskyvning som `+02:00`; tidspunkter uten tidssone avvises. Må ligge i fremtiden.

Må være en eksakt start på en tidsluke med gjenværende kapasitet – se
[Hent tilgjengelighet](https://docs.anivahealth.com/no/api/locations/get-availability.md). Timen som flyttes teller aldri mot sin
egen måltidsluke, men å flytte til en tidsluke der den samme profilen allerede har en *annen*
time, returnerer `409` med den timens `appointment_id`.

Hvis *målstedet* drives av Aniva, må det nye tidspunktet også være minst 12 timer frem i tid – se
[Minste varslingstid](https://docs.anivahealth.com/no/api/appointments/create-appointment.md#minimumsfrist).

**location\_id** `string`

UUID for det nye prøvestedet. Stedet må eksistere og være aktivt. Bruk [Vis
steder](https://docs.anivahealth.com/no/api/locations/list-locations.md) for å finne tilgjengelige steds-ID-er.

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

Erstatter listen med opptil 5 adresser som hver får én e-post når alle labresultatene er
endelige. Send `[]` for å slå av e-postene. Dette feltet kan fortsatt redigeres etter
blodprøvetakingen; bare en avbestilt time avviser det. Etter blodprøvetakingen må du sende det
alene: med `scheduled_at` eller `location_id` i samme body returnerer forespørselen `409`.
Nøkkelen din trenger `results_view`-tilgang til pasienten, ellers `403`. Se
[E-poster når resultater er klare](https://docs.anivahealth.com/no/concepts/results.md#e-poster-nar-resultater-er-klare).

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

Ny prøvetakingsmetode: `capillary` eller `venous`, eller `null` for å bruke stedets
`default_draw_method` igjen. Stedet må ha metoden i `draw_methods`, og de bestilte prøvene må være
mulige med den, ellers `400`. Når du flytter en time til et annet sted, kjøres den samme sjekken
der: på timens egen `draw_method`, ellers på det nye stedets `default_draw_method`.

## Respons

Ved suksess returnerer API-et `200 OK` med den oppdaterte timen og den innebygde profilen.

**id** `string` *required*

Unik timeidentifikator (UUID).

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

UUID for profilen denne timen tilhører.

**location\_id** `string`

UUID for teststedet der blodprøvetakingen finner sted.

**scheduled\_at** `string`

Avtalt tidspunkt for timen som et UTC-tidspunkt (ISO 8601 med `Z`-suffiks, f.eks.
`2026-05-20T14:00:00Z`). Kan være `null`.

**status** `string` *required*

Gjeldende status for timen. En av `pending`, `confirmed`, `blood_drawn` eller `cancelled`.
Detaljert status for laboratorieresultater henter du fra [Hent resultater](https://docs.anivahealth.com/no/api/appointments/get-results.md),
og mer detaljert fremdrift for forsendelser fra hvert element i den innebygde `shipments`-listen (se nedenfor)
videre til [Hent forsendelse](https://docs.anivahealth.com/no/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Fritekstårsak som ble registrert da timen ble avbestilt (f.eks. manglende oppmøte, sen avbestilling,
«Mislyktes. Må gjentas»). `null` med mindre `status` er `cancelled`.

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

Adresser som hver får én e-post når alle labresultater er endelige, i små bokstaver. Tom når den er slått av. Se
[E-poster om klare resultater](https://docs.anivahealth.com/no/concepts/results.md#e-poster-nar-resultater-er-klare).

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

Hvordan blodprøven tas: `capillary` (fingertupp eller overarm, i mikrorør) eller `venous` (fra vene,
i prøverør). Det er metoden som er satt på timen, ellers `default_draw_method` for
[stedet](https://docs.anivahealth.com/no/concepts/locations.md). Etter blodprøvetakingen er det metoden som ble brukt.

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

ISO 8601-tidsstempel for når timen ble opprettet.

**updated\_at** `string`

ISO 8601-tidsstempel for siste oppdatering. Kan være `null`.

**profile** `object` *required*

Pasientprofilen som er knyttet til denne timen.

**profil**

**id** `string`

Unik profilidentifikator (UUID).

**handle** `string`

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

**first\_name** `string`

Fornavn. Kan være `null`.

**last\_name** `string`

Etternavn. Kan være `null`.

**email** `string`

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

**phone** `string`

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

**sex** `integer`

Biologisk kjønn etter ISO/IEC 5218. Kan være `null`.

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

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

**height** `number`

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

**weight** `number`

Vekt i kilogram. Kan være `null`.

**language** `string`

Foretrukket språk: en av de 32 kodene i [Opprett profil](https://docs.anivahealth.com/no/api/profiles/create-profile.md).

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

Om denne profilen mottar transaksjonelle (programmatiske) e-poster. Kan være `null`.

**created\_at** `string`

ISO 8601-tidsstempel for når profilen ble opprettet.

**updated\_at** `string`

ISO 8601-tidsstempel for siste profiloppdatering. Kan være `null`.

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

Paneler som for øyeblikket er knyttet til denne timen. Utelater kansellerte tilknytninger. Slå opp
paneldetaljer (navn, biomarkører) via [Vis paneler](https://docs.anivahealth.com/no/api/panels/list-panels.md).

**Felt for tilknyttet panel**

**panel\_id** `string`

Panel-UUID – kryssreferer mot [Vis paneler](https://docs.anivahealth.com/no/api/panels/list-panels.md).

**added\_at** `string`

ISO 8601-tidsstempel for når panelet først ble knyttet til denne timen.

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

Enkeltbiomarkører knyttet til denne timen utenfor et panel (se [Legg til egendefinerte
biomarkører](https://docs.anivahealth.com/no/api/appointments/add-individual-biomarkers.md)). Kryssreferer hver `biomarker_id`
mot [Vis biomarkører](https://docs.anivahealth.com/no/api/biomarkers/list-biomarkers.md) for visningsdata.

**Felt for enkeltbiomarkør**

**biomarker\_id** `integer`

Biomarkøridentifikator – kryssreferer mot
[Vis biomarkører](https://docs.anivahealth.com/no/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

ISO 8601-tidsstempel for når biomarkøren først ble knyttet til denne timen.

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

Forsendelser koblet til denne timen, med eldste kobling først. Tom liste når ingen forsendelser er
koblet til. Slå opp hver `id` med [Hent forsendelse](https://docs.anivahealth.com/no/api/shipments/get-shipment.md) for
fullstendige forsendelsesdata.

**Felt for forsendelseskobling**

**id** `string`

Referanseidentifikator for forsendelsen – kryssreferer mot
[Hent forsendelse](https://docs.anivahealth.com/no/api/shipments/get-shipment.md).

**added\_at** `string`

ISO 8601-tidsstempel for når forsendelsen først ble koblet til denne timen.

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

Labkoder (strekkoder på prøverør) som er registrert for denne timen, i skannerekkefølge. Tom til blodprøvetakingen
er bekreftet. En venøs blodprøvetaking har én kode trykket på hvert prøverør; en kapillær blodprøvetaking har én
kode per mikrorør. Resultater og dokumenter i [Hent resultater](https://docs.anivahealth.com/no/api/appointments/get-results.md) refererer til
disse kodene via `lab_code`.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfeil – f.eks. ligger `scheduled_at` i fortiden, er mindre enn 12 timer frem i tid på et Aniva-drevet sted, ugyldig UUID-format, stedet har ikke beholdere på lager for `draw_method`, eller de bestilte testene er ikke mulige med `draw_method`. |
| `403` | Forbudt – API-nøkkelen din har ikke tilgang til denne operasjonen, timen eller stedet ligger utenfor tilgangskonteksten din, eller `results_ready_emails` er satt uten `results_view`-tilgang til pasienten. |
| `404` | Time eller sted ble ikke funnet. |
| `409` | Timen kan ikke endres (blodprøvetakingen er allerede bekreftet eller timen er avbestilt), det valgte tidspunktet er fullbooket, stedet er stengt den datoen, eller denne profilen har allerede en annen time på det valgte stedet og tidspunktet (inneholder `appointment_id`). |
| `500` | Intern serverfeil. |

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