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

# Aggiorna profilo

> Aggiorna un profilo paziente esistente

Aggiorna uno o più campi di un profilo paziente esistente. Devi includere solo i campi che vuoi modificare — tutti i parametri del body sono facoltativi.

Richiede lo scope `create_user`.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificativo univoco (UUID) del profilo da aggiornare.

### Parametri del body

**email** `string`

Nuovo indirizzo email del profilo.

**password** `string`

Nuova password. Deve contenere tra 8 e 128 caratteri.

**first\_name** `string`

Nuovo nome. Deve usare caratteri latini, tra 1 e 100 caratteri.

**last\_name** `string`

Nuovo cognome. Deve usare caratteri latini, tra 1 e 100 caratteri.

**phone** `string`

Nuovo numero di telefono in formato E.164 (ad es. `+14155552671`).

**sex** `integer`

Nuovo valore per il sesso biologico secondo ISO/IEC 5218 (`1` = maschio, `2` = femmina). `0` (sconosciuto) restituisce `400`.

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

Nuova data di nascita in formato `YYYY-MM-DD`. Deve essere nel passato e non precedente al 1900. L'età
risultante deve essere compresa tra 16 e 100 anni.

**height** `number`

Nuova altezza in centimetri.

**weight** `number`

Nuovo peso in chilogrammi.

**language** `string`

Nuova lingua preferita: `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` o `uk`.

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

Indica se questo profilo deve ricevere email transazionali (programmatiche) — conferme di
appuntamento, avvisi di risultati pronti, ecc. Distinto dal consenso marketing. Ometti il campo
per mantenere il valore attuale.

## Risposta

In caso di successo, l'API restituisce `200 OK` con il profilo completo aggiornato.

**id** `string` *required*

Identificativo univoco del profilo (UUID).

**handle** `string`

Handle o nome utente del profilo. Può essere `null`.

**first\_name** `string`

Nome. Può essere `null`.

**last\_name** `string`

Cognome. Può essere `null`.

**email** `string`

Indirizzo email. Può essere `null`.

**phone** `string`

Numero di telefono in formato E.164. Può essere `null`.

**sex** `integer`

Sesso biologico secondo ISO/IEC 5218 (`0` = sconosciuto, `1` = maschio, `2` = femmina). Può essere `null`.

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

Data di nascita in formato `YYYY-MM-DD`. Può essere `null`.

**height** `number`

Altezza in centimetri. Può essere `null`.

**weight** `number`

Peso in chilogrammi. Può essere `null`.

**language** `string`

Lingua preferita, uno dei 32 codici sopra.

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

Indica se questo profilo riceve email transazionali (programmatiche). `null` se non è mai stato impostato.

**created\_at** `string`

Timestamp ISO 8601 della creazione del profilo.

**updated\_at** `string`

Timestamp ISO 8601 dell'ultimo aggiornamento. Può essere `null`.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Errore di validazione — uno o più campi non hanno superato la validazione. |
| `403` | Accesso negato — la tua chiave API non ha accesso a questa operazione o il profilo è fuori dal tuo contesto di accesso. |
| `404` | Profilo non trovato. |
| `500` | Errore interno del server. |

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