`UserMeBundle`

Bundle consolidado del usuario autenticado. Devuelto por GET /v1/users/me. Incluye perfil, metadatos de API key, suscripción activa, estado de 2FA, permisos del rol y resumen de notificaciones en un solo roundtrip.

Propiedades

Campo	Tipo	Descripción
`id`	`string (uuid)`	Identificador único del usuario (UUID v7).
`email`	`string (email)`	Correo electrónico del usuario, usado para login y notificaciones.
`name`	`string`	Nombre completo del usuario tal como aparece en el panel.
`role`	`string`	Rol del usuario en la organización. Determina los permisos disponibles. `owner` — dueño de la cuenta; `admin` — la administra; `user` — la usa; `viewer` — solo consulta.
`status`	`string`	Estado de la cuenta. Solo `active` permite operar la API. `suspended` — cuenta suspendida; `pending_verification` — falta verificar el correo.
`timezone`	`string`	Zona horaria IANA del usuario, usada para formatear timestamps en la UI.
`language`	`string`	Idioma preferido del usuario para UI y notificaciones. `es` para castellano, `en` para inglés.
`email_verified_at`	`string \| null`	Timestamp ISO 8601 UTC de cuando el usuario verificó su email. `null` si pendiente.
`created_at`	`string (date-time)`	Timestamp ISO 8601 UTC de creación de la cuenta.
`api_key`	`object \| null`	Metadatos de la API key. Nunca devuelve la key completa (usar POST /v1/users/me/api-key/reveal con password para revelar).
`prefix`	`string`	Prefijo de la API key para identificación visual. No incluye la clave completa.
`last_4`	`string \| null`	Últimos 4 caracteres de la API key para render enmascarado (`example_a1b••••••f9c2`). `null` en cuentas anteriores a que se guardara ese dato, hasta que se rellena.
`subscription`	`object \| null`	Suscripción activa del usuario. `null` si no hay plan activo.
`plan_slug`	`string`	Identificador del plan contratado (free, pro, enterprise, etc.).
`status`	`string`	Estado actual de la suscripción según el ciclo de facturación. `active` — al corriente; `trialing` — en periodo de prueba; `past_due` — con un cobro pendiente; `canceled` — cancelada; `paused` — en pausa.
`current_period_end`	`string \| null`	Fin del periodo de billing actual (ISO 8601 UTC).
`cancel_at`	`string \| null`	Fecha programada de cancelación si el usuario inició cancel-at-period-end. `null` si no hay cancelación pendiente.
`billing_interval`	`string \| null`	Frecuencia de facturación del plan contratado. `month` cobra cada mes, `year` cada año y `once` marca un cobro único, sin renovación.
`two_factor`	`object`	Estado del segundo factor de autenticación.
`enabled`	`boolean`	`true` si el usuario tiene 2FA activado.
`method`	`string \| null`	Canal de entrega del OTP. `null` si 2FA está deshabilitado. `sms` manda el código por mensaje de texto; `email`, por correo.
`last_used_at`	`string \| null`	Último uso exitoso del 2FA. Campo futuro, hoy siempre `null`.
`permissions`	`array`	Lista plana de permisos del rol del usuario en formato `resource:action`.
`notifications`	`object`	Resumen de la cola de notificaciones del usuario.
`unread_count`	`integer`	Número de notificaciones sin leer ni archivar.
`push_enabled`	`boolean`	`true` si el usuario tiene al menos una suscripción push activa.
`telegram_linked`	`boolean`	`true` si el usuario tiene un chat de Telegram vinculado.
`_warnings`	`array`	Lista de subsistemas que fallaron al construir este bundle. Solo presente si hubo fallos parciales. Los campos correspondientes a cada subsistema fallido estarán en su valor por defecto (null o vacío). Permite al cliente degradar gracefully en lugar de mostrar pantalla en blanco.

Usado en operaciones

GET /v1/users/me