# users

Manage users and invitations in your CARTO organization.

User management commands require admin or superadmin permissions. Regular users may not have access to view all organization users; invitation commands require permission to invite users to the organization.

## `carto users list`

List users.

```bash
carto users list
carto users list --page 1 --page-size 20
carto users list --role Builder
carto users list --search "john"
carto users list --all
```

**Options:**

| Option            | Description                                   |
| ----------------- | --------------------------------------------- |
| `--page <n>`      | Page number.                                  |
| `--page-size <n>` | Items per page.                               |
| `--role <role>`   | Filter by role: `Builder`, `Viewer`, `Guest`. |
| `--search <term>` | Search users by name or email.                |
| `--all`           | Fetch all pages automatically.                |

## `carto users get <user>`

Get detailed information for a user. Accepts a user ID or an email address.

```bash
carto users get google-oauth2|123456789
carto users get jatorre@carto.com
carto users get <user-id> --json
```

Output includes the user profile, roles, organization, identities, and groups.

## `carto users invite <email[,email...]> [email...]`

Invite one or more users to the organization. Both comma-separated and multi-argument forms are accepted.

```bash
# Single user
carto users invite user@example.com --role Builder

# Default role is Viewer
carto users invite user@example.com

# Comma-separated
carto users invite user1@example.com,user2@example.com,user3@example.com --role Builder

# Multiple arguments
carto users invite user1@example.com user2@example.com --role Viewer
```

**Options:**

| Option                            | Description                        |
| --------------------------------- | ---------------------------------- |
| `--role <Builder\|Viewer\|Guest>` | Role to assign. Default: `Viewer`. |

**Available roles:**

* **Builder** — full access to create and edit maps, workflows, and connections.
* **Viewer** — read-only access to view maps and data.
* **Guest** — limited access, typically for external collaborators.

## `carto users invitations`

List pending invitations.

```bash
carto users invitations
carto users invitations --json
```

## `carto users resendInvitation <invitation-id>`

Resend a pending invitation.

## `carto users cancelInvitation <invitation-id>`

Cancel a pending invitation.

## `carto users delete <user>`

Remove a user from the organization. Requires admin permissions.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.carto.com/carto-for-agents/cli/command-reference/users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.