List and inspect deployments

Use the CLI to list deployments for a project and inspect a specific deployment by ID or URL.

List deployments

List deployments for the linked project, or pass a project slug or ID:

easel list
easel ls my-app
easel list --prod
easel list --environment preview --status READY --limit 20

Useful filters:

Option	Description
`--status`	Comma-separated statuses (`READY`, `BUILDING`, and others)
`--environment`	`production` or `preview`
`--prod`	Shorthand for `--environment production`
`--limit`	Maximum number of deployments to return
`--cursor`	Pagination cursor from a previous response

Human output prints a table of ID, status, environment, branch, age, and URL. Use --format json when you need machine-readable output.

Inspect a deployment by ID or by its deployment URL:

easel inspect dpl_1234567890
easel inspect https://my-app-git-main-acme.preview.easelusercontent.com

Optional flags:

Option	Description
`-l, --logs`	Print build logs
`--wait`	Wait until the deployment reaches a terminal status
`--timeout`	Timeout for `--wait` (for example `5m`, `30s`; default `3m`)

Terminal statuses are READY, ERROR, CANCELLED, and SPUN_DOWN.

easel inspect dpl_1234567890 --wait --timeout 5m --logs

Upload local source and create a deployment.

Query and follow request logs.

Preview vs production behavior and branch configuration.