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

# Actualizar perfil

> Actualizar un perfil de paciente existente

Actualiza uno o más campos de un perfil de paciente existente. Solo tienes que incluir los campos que quieras cambiar: todos los parámetros del cuerpo son opcionales.

Requiere el scope `create_user`.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) del perfil que quieres actualizar.

### Parámetros del cuerpo

**email** `string`

Nueva dirección de correo electrónico para el perfil.

**password** `string`

Nueva contraseña. Debe tener entre 8 y 128 caracteres.

**first\_name** `string`

Nuevo nombre. Debe usar caracteres latinos y tener entre 1 y 100 caracteres.

**last\_name** `string`

Nuevo apellido. Debe usar caracteres latinos y tener entre 1 y 100 caracteres.

**phone** `string`

Nuevo número de teléfono en formato E.164 (p. ej., `+14155552671`).

**sex** `integer`

Nuevo valor de sexo biológico según ISO/IEC 5218 (`1` = masculino, `2` = femenino). `0` (desconocido) devuelve `400`.

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

Nueva fecha de nacimiento en formato `YYYY-MM-DD`. Debe ser una fecha pasada y no anterior a 1900. La edad
resultante debe estar entre 16 y 100 años.

**height** `number`

Nueva altura en centímetros.

**weight** `number`

Nuevo peso en kilogramos.

**language** `string`

Nuevo idioma preferido: `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 si este perfil debe recibir correos transaccionales (programáticos), como confirmaciones
de cita, avisos de resultados disponibles, etc. Es independiente de la suscripción a marketing.
Omítelo para mantener el valor actual.

## Respuesta

Si la operación tiene éxito, la API devuelve `200 OK` con el perfil completo actualizado.

**id** `string` *required*

Identificador único del perfil (UUID).

**handle** `string`

Alias o nombre de usuario del perfil. Puede ser `null`.

**first\_name** `string`

Nombre. Puede ser `null`.

**last\_name** `string`

Apellidos. Puede ser `null`.

**email** `string`

Dirección de correo electrónico. Puede ser `null`.

**phone** `string`

Número de teléfono en formato E.164. Puede ser `null`.

**sex** `integer`

Sexo biológico según ISO/IEC 5218 (`0` = desconocido, `1` = masculino, `2` = femenino). Puede ser `null`.

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

Fecha de nacimiento en formato `YYYY-MM-DD`. Puede ser `null`.

**height** `number`

Altura en centímetros. Puede ser `null`.

**weight** `number`

Peso en kilogramos. Puede ser `null`.

**language** `string`

Idioma preferido, uno de los 32 códigos anteriores.

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

Indica si este perfil recibe correos electrónicos transaccionales (programáticos). `null` si nunca se ha configurado.

**created\_at** `string`

Marca de tiempo ISO 8601 de creación del perfil.

**updated\_at** `string`

Marca de tiempo ISO 8601 de la última actualización. Puede ser `null`.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Error de validación: uno o más campos no superaron la validación. |
| `403` | Prohibido: tu clave de API no tiene acceso a esta operación o el perfil está fuera de tu contexto de acceso. |
| `404` | Perfil no encontrado. |
| `500` | Error interno del servidor. |

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