> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeplo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Users

> List, create, and delete users in your Zeplo account

Manage the users in your Zeplo project. These commands let you list all users, create new ones, and remove users by their ID.

## zeplo users list

List all users in your Zeplo project. Displays each user's ID, name, email, and creation date in a formatted table.

```bash theme={null}
zeplo users list
```

### Options

| Flag | Description |
| - | - |
| `--json` | Output the list as a JSON array instead of a formatted table. |
| `--limit <n>` | Limit the number of users returned. Defaults to `25`. |
| `--offset <n>` | Skip the first `n` users. Useful for paginating through large user lists. |
| `--search <query>` | Filter users by name or email matching the given query string. |

### Examples

```bash theme={null}
# List all users
zeplo users list

# List users as JSON for scripting
zeplo users list --json

# Search for a specific user by email
zeplo users list --search "alice@example.com"

# Paginate through users
zeplo users list --limit 10 --offset 20
```

## zeplo users create

Create a new user in your Zeplo project. By default, this launches an interactive prompt that collects the user's details. You can also provide all required fields via flags for non-interactive use.

```bash theme={null}
zeplo users create
```

### Options

| Flag | Description |
| - | - |
| `--name <name>` | The full name of the user. |
| `--email <email>` | The email address of the user. |
| `--role <role>` | The role to assign. Accepts `admin`, `member`, or `viewer`. Defaults to `member`. |
| `--send-invite` | Send an invitation email to the newly created user. |

### Examples

```bash theme={null}
# Create a user interactively
zeplo users create

# Create a user non-interactively with all details
zeplo users create --name "Alice Johnson" --email alice@example.com --role admin

# Create and send an invitation email
zeplo users create --name "Bob Smith" --email bob@example.com --send-invite
```

## zeplo users delete

Delete a user by their ID. This action is permanent and cannot be undone. The command prompts for confirmation before proceeding unless the `--force` flag is used.

```bash theme={null}
zeplo users delete <id>
```

### Arguments

| Argument | Description |
| - | - |
| `<id>` | The ID of the user to delete. Find user IDs using `zeplo users list`. |

### Options

| Flag | Description |
| - | - |
| `--force` | Skip the confirmation prompt and delete immediately. |

### Examples

```bash theme={null}
# Delete a user with confirmation prompt
zeplo users delete usr_5k2n8w

# Delete a user without confirmation
zeplo users delete usr_5k2n8w --force
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.