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

# Päivitä profiili

> Päivitä olemassa oleva potilasprofiili

Päivitä yksi tai useampi kenttä olemassa olevassa potilasprofiilissa. Sinun tarvitsee sisällyttää vain kentät, joita haluat muuttaa — kaikki body-parametrit ovat valinnaisia.

Vaatii `create_user`-oikeuden.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Päivitettävän profiilin yksilöivä tunniste (UUID).

### Runkoparametrit

**email** `string`

Profiilin uusi sähköpostiosoite.

**password** `string`

Uusi salasana. Pituuden on oltava 8–128 merkkiä.

**first\_name** `string`

Uusi etunimi. Käytettävä latinalaisia merkkejä, pituus 1–100 merkkiä.

**last\_name** `string`

Uusi sukunimi. Käytettävä latinalaisia merkkejä, pituus 1–100 merkkiä.

**phone** `string`

Uusi puhelinnumero E.164-muodossa (esim. `+14155552671`).

**sex** `integer`

Uusi biologinen sukupuoli standardin ISO/IEC 5218 mukaisesti (`1` = mies, `2` = nainen). `0` (tuntematon) palauttaa `400`.

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

Uusi syntymäaika `YYYY-MM-DD`-muodossa. On oltava menneisyydessä eikä ennen vuotta 1900. Laskennallisen
iän on oltava 16–100 vuotta.

**height** `number`

Uusi pituus senttimetreinä.

**weight** `number`

Uusi paino kilogrammoina.

**language** `string`

Uusi ensisijainen kieli: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` tai `uk`.

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

Vastaanottaako tämä profiili transaktionaalisia (automaattisia) sähköposteja — ajanvarausvahvistuksia,
ilmoituksia valmistuneista tuloksista jne. Erillinen markkinointiluvasta. Jätä pois säilyttääksesi
nykyisen arvon.

## Vastaus

Onnistuessaan API palauttaa `200 OK` ja koko päivitetyn profiilin.

**id** `string` *required*

Profiilin yksilöllinen tunniste (UUID).

**handle** `string`

Profiilin nimimerkki tai käyttäjätunnus. Voi olla `null`.

**first\_name** `string`

Etunimi. Voi olla `null`.

**last\_name** `string`

Sukunimi. Voi olla `null`.

**email** `string`

Sähköpostiosoite. Voi olla `null`.

**phone** `string`

Puhelinnumero E.164-muodossa. Voi olla `null`.

**sex** `integer`

Biologinen sukupuoli ISO/IEC 5218 -standardin mukaan (`0` = tuntematon, `1` = mies, `2` = nainen). Voi olla `null`.

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

Syntymäaika `YYYY-MM-DD`-muodossa. Voi olla `null`.

**height** `number`

Pituus senttimetreinä. Voi olla `null`.

**weight** `number`

Paino kilogrammoina. Voi olla `null`.

**language** `string`

Ensisijainen kieli, yksi yllä olevista 32 koodista.

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

Vastaanottaako profiili tapahtumapohjaisia (ohjelmallisia) sähköposteja. `null`, jos arvoa ei ole koskaan asetettu.

**created\_at** `string`

ISO 8601 -aikaleima profiilin luontihetkestä.

**updated\_at** `string`

ISO 8601 -aikaleima viimeisimmästä päivityksestä. Voi olla `null`.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Validointivirhe — yksi tai useampi kenttä ei läpäissyt validointia. |
| `403` | Kielletty — API-avaimellasi ei ole oikeutta tähän toimintoon tai profiili on pääsykontekstisi ulkopuolella. |
| `404` | Profiilia ei löytynyt. |
| `500` | Sisäinen palvelinvirhe. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/profiles/a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "phone": "+4917612345678",
    "language": "en"
  }'
```

```json 200 theme={null}
{
  "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "handle": null,
  "first_name": "Maria",
  "last_name": "Schmidt",
  "email": "maria.schmidt@example.com",
  "phone": "+4917612345678",
  "sex": 2,
  "date_of_birth": "1985-03-22",
  "height": 168,
  "weight": 65,
  "language": "en",
  "transactional_emails_enabled": true,
  "created_at": "2026-04-01T09:14:32Z",
  "updated_at": "2026-04-01T14:22:11Z"
}
```

```json 400 theme={null}
{
  "error": "phone: Phone must be in E.164 format (e.g., +14155552671)"
}
```

```json 404 theme={null}
{
  "error": "Profile not found"
}
```


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