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

# Vytvořit profil

> Návod krok za krokem: vytvoř a uprav profily pacientů v Aniva Partner API, než rezervuješ krevní test.

Podle tohoto průvodce vytvoříš profil pacienta a přiřadíš ho do své skupiny profilů. Profily jsou výchozím bodem pro plánování termínů a spouštění laboratorních objednávek.

**1. Získej referenci své skupiny profilů**

Každý profil musí být přiřazen ke skupině profilů, která patří k tvému partnerskému účtu. Pole `profile_group` přijímá buď neměnné UUID skupiny, nebo její čitelný slug — UUID má přednost, protože se nikdy nemění a přežije i přejmenování slugu.

Pokud referenci své skupiny profilů neznáš, kontaktuj Aniva a vyžádej si ji. Bez platné reference nemůžeš vytvářet profily.

**2. Vytvoř profil**

Pošli požadavek `POST` na `/api/v1/profiles` s demografickými údaji pacienta.

> [!NOTE]
>
> Pole `first_name` i `last_name` jsou povinná. Přijímají pouze písmena latinky (včetně písmen s diakritikou, jako je ü), mezery, spojovníky a apostrofy. Jména v jiných písmech před odesláním přepiš do latinky.

> [!NOTE]
>
> Pokud vynecháš `email`, Aniva pro profil automaticky vygeneruje zástupnou e-mailovou adresu. Později ji můžeš upravit požadavkem `PATCH`.

> [!TIP]
>
> Pole `language` určuje jazyk, který Aniva používá při komunikaci s pacientem – například pro připomínky termínů a oznámení o výsledcích. Nastav ho podle preferovaného jazyka pacienta. Podporované hodnoty najdeš na stránce [Vytvořit profil](https://docs.anivahealth.com/cs/api/profiles/create-profile.md). Výchozí hodnota je `en`.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "first_name": "Emma",
    "last_name": "Müller",
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "profile_group": "my-clinic-group",
    "email": "emma.muller@example.com",
    "language": "de"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/profiles', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    first_name: 'Emma',
    last_name: 'Müller',
    sex: 2,
    date_of_birth: '1990-04-15',
    profile_group: 'my-clinic-group',
    email: 'emma.muller@example.com',
    language: 'de',
  }),
});

const profile = await response.json();
```

Úspěšný požadavek vrátí `201 Created` s objektem nového profilu:

```json theme={null}
{
  "id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "handle": null,
  "first_name": "Emma",
  "last_name": "Müller",
  "email": "emma.muller@example.com",
  "phone": null,
  "sex": 2,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "de",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T09:14:22Z",
  "updated_at": null
}
```

Ulož si `id` — budeš ho potřebovat k plánování termínů a úpravě profilu.

**3. Uprav profil (volitelné)**

Pomocí `PATCH /api/v1/profiles/{id}` můžeš po vytvoření upravit libovolná pole profilu. Všechna pole jsou volitelná — uveď jen ta, která chceš změnit.

Následující příklad přidá telefonní číslo a výšku:

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56 \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "phone": "+4915123456789",
    "height": 168.5
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
  {
    method: 'PATCH',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      phone: '+4915123456789',
      height: 168.5,
    }),
  }
);

const updated = await response.json();
```

Úspěšný požadavek vrátí `200 OK` s celým aktualizovaným objektem profilu.

## Zpracování chyb

| Stav | Příčina | Řešení |
| - | - | - |
| `400 Bad Request` | Chybí povinné pole, hodnota je mimo rozsah nebo `date_of_birth` není věrohodné (v budoucnosti, před rokem 1900 nebo odpovídá věku mimo rozmezí 16–100 let). | Zkontroluj konkrétní validační zprávu v těle chybové odpovědi a požadavek oprav. |
| `403 Forbidden` | Tvůj API klíč nemá přístup k této operaci nebo nemáš přístup k zadané skupině profilů. | Kontaktuj Aniva a ověř oprávnění svého API klíče a přístup ke skupině profilů. |
| `404 Not Found` | Hodnota `profile_group` neodpovídá žádné skupině profilů na tvém účtu (ani podle UUID, ani podle slugu). | Ověř, že je reference správná. Pokud své UUID nebo slug neznáš s jistotou, kontaktuj Aniva. |
| `409 Conflict` | Pro tento `email` už profil existuje (`error_name: "email_exists_error"`), nebo byl `Idempotency-Key` znovu použit s jiným tělem požadavku. | Použij stávající profil pro tento e-mail, nebo pošli nový `Idempotency-Key`. |


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