---
title: "User"
description: "The `User` entity."
section: "Reference"
group: "Types"
order: 249
---

## Definition

```ts
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.                                                                                           |