*API REST › Objetos › Cuenta y acceso*

# Usuario

> Una persona con acceso a la cuenta, con el rol que tiene en ella.

Una persona con acceso a la cuenta, con el rol que tiene, si la administra, el estado de su acceso y el miembro del personal al que está vinculada. Los usuarios son las personas que inician sesión en Filmo, no el personal. No se publican credenciales, sesiones, permisos ni preferencias, y solo los administradores pueden leerlos.

Esquemas: `UserDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único del usuario. Es el valor que otros recursos llevan en `createdBy`, `mentionedUserIds` y similares. |
| `name` | string | Nombre visible. |
| `email` | string | Email con el que la persona inicia sesión. |
| `role` | object | Rol en esta cuenta. |
| `role.id` | string | Identificador del rol: owner, super-admin, admin, un rol predefinido o `custom`. |
| `role.name` | string | Nombre del rol, en el idioma de la cuenta. |
| `isAdmin` | boolean | true cuando el rol administra la cuenta. |
| `status` | string | Estado del acceso: active, pending (invitado, aún sin aceptar) o inactive. `active`, `pending`, `inactive` |
| `staffMemberId` | string | Identificador del miembro del personal al que está vinculado este usuario (consulta `/api/v1/staff`); null si ninguno. |
| `createdAt` | string<date-time> | Fecha en que se creó la cuenta de usuario en ISO 8601 UTC; null para una invitación aún no aceptada. |
| `updatedAt` | string<date-time> | Fecha de la última modificación de la cuenta de usuario en ISO 8601 UTC; null para una invitación aún no aceptada. |

## Valores

| Campo | Valores |
| --- | --- |
| `status` | `active`, `pending`, `inactive` |

## Ejemplo

*User · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "name": "Example",
  "email": "ana@example.com",
  "role": {
    "id": "id_8f2a1c",
    "name": "Example"
  },
  "isAdmin": true,
  "status": "active",
  "staffMemberId": "string",
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/users`](https://docs.filmo.io/es/rest-api/endpoint-reference/users/list-users) — Listar usuarios

## Lo modifican

Ninguna operación.

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/user  
Última actualización: 2026-10-25