User

The `User` entity.

Definition

TypeScript

interface User {
  id: string;
  name: string;
  email: string;
  handle: string;
  role: "admin" | "user" | "service";
  emailVerified: boolean;
  createdAt: string;
}

Fields

Field	Type	Notes
`id`	`string`	`readonly` `required`
`name`	`string`	`required` — Display name shown in the UI.
`email`	`string`	`required` — Primary email address, used for sign-in.
`handle`	`string`	`required` — Globally unique user handle.
`role`	`"admin" \| "user" \| "service"`	`required` — Account role ('user', 'admin', or 'service'). Service users are headless caller identities scoped to a workspace and cannot sign in.
`emailVerified`	`boolean`	`required` — True once the user has verified their email address.
`createdAt`	`string`	`readonly` `required` — ISO-8601 timestamp of creation.