> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryzeapi.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Resumen

> Administra tu propio perfil (foto, nombre, estado), consulta a terceros y configura la privacidad

**Auth:** `TokenAccount` o `TokenInstance` en cada ruta. Cada llamada valida la propiedad de la instancia.

Esta sección cubre las rutas `/api/profile/*` para actualizar tu propio perfil, consultar perfiles de terceros y leer o actualizar la configuración de privacidad de WhatsApp.

## Endpoints

| Method | Path                                | Función                                                              |
| ------ | ----------------------------------- | -------------------------------------------------------------------- |
| POST   | `/api/profile/account/:instance`    | [Actualizar foto / nombre / estado](/es/api/profile/update-account)  |
| GET    | `/api/profile/getAccount/:instance` | [Obtener tu perfil o el de un tercero](/es/api/profile/read-account) |
| GET    | `/api/profile/getPrivacy/:instance` | [Obtener configuración de privacidad](/es/api/profile/read-privacy)  |
| GET    | `/api/profile/privacy/:instance`    | [Alias de `/getPrivacy`](/es/api/profile/read-privacy-alias)         |
| POST   | `/api/profile/privacy/:instance`    | [Actualizar privacidad](/es/api/profile/update-privacy)              |

## Estructura de privacidad

La API agrupa los ajustes en tres sub-objetos: `visibility`, `privacy` y `permissions`.

```json theme={null}
{
  "visibility": {
    "lastSeen": "contacts",
    "status": "all",
    "profile": "contacts",
    "online": "match_last_seen"
  },
  "privacy": {
    "readReceipts": "all"
  },
  "permissions": {
    "callAdd": "all",
    "groupAdd": "contacts"
  }
}
```

### Valores aceptados por campo

| Campo                             | Valores                                           |
| --------------------------------- | ------------------------------------------------- |
| `lastSeen` / `status` / `profile` | `all` / `contacts` / `contact_blacklist` / `none` |
| `online`                          | `all` / `match_last_seen`                         |
| `readReceipts`                    | `all` / `none`                                    |
| `callAdd`                         | `all` / `known`                                   |
| `groupAdd`                        | `all` / `contacts` / `contact_blacklist`          |

## Modelo `AccountProfileData`

Respuesta de [`GET /getAccount`](/es/api/profile/read-account):

```json theme={null}
{
  "profilePicture": "https://pps.whatsapp.net/...",
  "profileName": "João Silva",
  "profileStatus": "Disponivel",
  "phoneNumber": "5511999999999",
  "jid": "5511999999999@s.whatsapp.net",
  "lid": "199789077627112@lid"
}
```

## Envoltorio de error

```json theme={null}
{
  "success": false,
  "error": { "message": "At least one field must be provided (profilePicture, profileName, or profileStatus)" }
}
```

## Referencia de errores (resumen)

| Categoría  | Mensaje                                                                               |
| ---------- | ------------------------------------------------------------------------------------- |
| Validación | `At least one field must be provided (profilePicture, profileName, or profileStatus)` |
| Validación | `At least one privacy setting must be provided`                                       |
| Validación | `Invalid <field> value: <value>. Valid values: ...`                                   |
| Estado     | `Instance is not connected to WhatsApp`                                               |
| Número     | `Number not found or not registered on WhatsApp`                                      |
| Número     | `invalid LID format`                                                                  |
| Falla      | `failed to update <field> privacy: <reason>`                                          |

## Siguiente

<CardGroup cols={2}>
  <Card title="Actualizar cuenta" icon="user-pen" href="/es/api/profile/update-account">
    Cambia foto, nombre visible o estado.
  </Card>

  <Card title="Actualizar privacidad" icon="shield" href="/es/api/profile/update-privacy">
    Ajusta quién ve qué.
  </Card>
</CardGroup>