`UserMeBundle`

Consolidated bundle for the authenticated user. Returned by GET /v1/users/me. Includes profile, API key metadata, active subscription, 2FA state, role permissions and notification summary in one roundtrip.

Properties

Field	Type	Description
`id`	`string (uuid)`	Unique user identifier (UUID v7).
`email`	`string (email)`	User email, used for login and notifications.
`name`	`string`	User's display name as shown in the dashboard.
`role`	`string`	User's role in the organization. Determines available permissions. `owner` — account owner; `admin` — administers it; `user` — uses it; `viewer` — read-only.
`status`	`string`	Account status. Only `active` allows API operations. `suspended` — account suspended; `pending_verification` — the email is still unverified.
`timezone`	`string`	User's IANA timezone, used to format timestamps in the UI.
`language`	`string`	User's preferred language for UI and notifications. `es` for Spanish, `en` for English.
`email_verified_at`	`string \| null`	ISO 8601 UTC timestamp when the user verified their email. `null` if pending.
`created_at`	`string (date-time)`	ISO 8601 UTC timestamp when the account was created.
`api_key`	`object \| null`	API key metadata. Never returns the full key (use POST /v1/users/me/api-key/reveal with password to reveal).
`prefix`	`string`	API key prefix for visual identification. Does not include the full key.
`last_4`	`string \| null`	Last 4 characters of the API key for masked rendering (`example_a1b••••••f9c2`). `null` for accounts predating that field, until it is backfilled.
`subscription`	`object \| null`	User's active subscription. `null` if no active plan.
`plan_slug`	`string`	Identifier of the subscribed plan (free, pro, enterprise, etc.).
`status`	`string`	Current subscription status per the billing cycle. `active` — up to date; `trialing` — in trial; `past_due` — a charge is outstanding; `canceled` — cancelled; `paused` — paused.
`current_period_end`	`string \| null`	End of the current billing period (ISO 8601 UTC).
`cancel_at`	`string \| null`	Scheduled cancellation date if the user initiated cancel-at-period-end. `null` if no cancellation is pending.
`billing_interval`	`string \| null`	Billing frequency of the subscribed plan. `month` bills monthly, `year` yearly, and `once` marks a one-off charge with no renewal.
`two_factor`	`object`	Two-factor authentication state.
`enabled`	`boolean`	`true` if the user has 2FA enabled.
`method`	`string \| null`	OTP delivery channel. `null` if 2FA is disabled. `sms` sends the code by text message; `email`, by mail.
`last_used_at`	`string \| null`	Last successful 2FA use. Future field, currently always `null`.
`permissions`	`array`	Flat list of the user's role permissions in `resource:action` format.
`notifications`	`object`	Summary of the user's notification queue.
`unread_count`	`integer`	Number of unread, non-archived notifications.
`push_enabled`	`boolean`	`true` if the user has at least one active push subscription.
`telegram_linked`	`boolean`	`true` if the user has a linked Telegram chat.
`_warnings`	`array`	List of subsystems that failed while building this bundle. Only present when partial failures occurred. The fields corresponding to each failed subsystem will be at their default value (null or empty). Allows the client to degrade gracefully instead of going dark.

Used in operations

GET /v1/users/me