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.

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.

carto users get google-oauth2|123456789
carto users get [email protected]
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.

# Single user
carto users invite [email protected] --role Builder

# Default role is Viewer
carto users invite [email protected]

# Comma-separated
carto users invite [email protected],[email protected],[email protected] --role Builder

# Multiple arguments
carto users invite [email protected] [email protected] --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.

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.