Command reference

Every CARTO CLI command, organized by command group. The CLI uses a hierarchical structure:

carto [global-options] <command> <subcommand> [args...]

For global options (--json, --debug, --profile, …) and environment variables, see Configuration.

Group	Purpose
auth	Personal authentication: log in, log out, switch profiles, check status.
credentials	Manage application credentials (API tokens, SPA OAuth clients, M2M OAuth clients).
maps	Manage Builder maps: create, update, validate, publish, schema, agents, copy, screenshot (experimental).
workflows	Manage Workflows: create, update, validate, verify, run, share, schedule, mcp publish.
projects	Manage projects (folders) that group maps and workflows, with local-sync workflow.
connections	Manage data warehouse connections.
named-sources	Manage Named Sources — server-side aliases for SQL queries.
do	Data Observatory: browse, search, sample, subscribe to spatial datasets.
imports	Import geospatial files (CSV, GeoJSON, GeoPackage, Shapefile, …) from local files or URLs.
export	Export warehouse tables to file (GeoParquet, GeoJSON, Shapefile, CSV, …) or cloud storage.
transfer	Transfer data between warehouses.
sql	Run SQL queries (returns results) and SQL jobs (DDL/DML) on your data warehouse.
org	View organization statistics, resources, and quotas.
users	Manage organization users and pending invitations.
activity	Query and export activity logs and usage data (Enterprise Large+).
admin	Superadmin operations: list-all, batch-delete, transfer.
ai	Chat with map AI agents (aifeature) and access CARTO's LLM proxy (aiproxy).