Skip to main content
PATCH
/
api
/
v1
/
profiles
/
{id}
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"
  }'
{
  "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",
  "created_at": "2026-04-01T09:14:32Z",
  "updated_at": "2026-04-01T14:22:11Z"
}
Update one or more fields on an existing patient profile. You only need to include the fields you want to change — all body parameters are optional.
Requires the CREATE_USER scope. Requests made with a key that lacks this scope return 403 Forbidden.

Request

Path parameters

id
string
required
Unique identifier (UUID) of the profile to update.

Body parameters

email
string
New email address for the profile.
password
string
New password. Must be between 8 and 128 characters.
first_name
string
New first name. Must use latin characters, between 1 and 100 characters.
last_name
string
New last name. Must use latin characters, between 1 and 100 characters.
phone
string
New phone number in E.164 format (e.g., +14155552671).
sex
integer
New biological sex value per ISO/IEC 5218 (1 = male, 2 = female).
date_of_birth
string
New date of birth in YYYY-MM-DD format.
height
number
New height in centimeters.
weight
number
New weight in kilograms.
language
string
New preferred language. Accepted values: en, de, fi.

Response

On success, the API returns 200 OK with the full updated profile.
id
string
required
Unique profile identifier (UUID).
handle
string
Profile handle or username. May be null.
first_name
string
First name. May be null.
last_name
string
Last name. May be null.
email
string
Email address. May be null.
phone
string
Phone number in E.164 format. May be null.
sex
integer
Biological sex per ISO/IEC 5218 (1 = male, 2 = female). May be null.
date_of_birth
string
Date of birth in YYYY-MM-DD format. May be null.
height
number
Height in centimeters. May be null.
weight
number
Weight in kilograms. May be null.
language
string
Preferred language (en, de, or fi).
created_at
string
ISO 8601 timestamp of when the profile was created.
updated_at
string
ISO 8601 timestamp of the last update. May be null.

Error responses

StatusDescription
400Validation error — one or more fields failed validation.
403Forbidden — missing CREATE_USER scope or profile is outside your access context.
404Profile not found.
500Internal server error.
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"
  }'
{
  "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",
  "created_at": "2026-04-01T09:14:32Z",
  "updated_at": "2026-04-01T14:22:11Z"
}