Deployments CLI reference

The deployments command lets you view and manage deployment history for your projects.

All deployments commands require --project-id.

Note

To report a new deployment, use the hb deploy command (Reporting API). The deployments command is for viewing and managing existing deployment records.

List deployments

hb deployments list --project-id 12345

With filters

# Filter by environment
hb deployments list --project-id 12345 --environment production

# Filter by user
hb deployments list --project-id 12345 --local-user johndoe

# Filter by time range (Unix timestamps)
hb deployments list --project-id 12345 --created-after 1704067200 --created-before 1706745600

# Limit results
hb deployments list --project-id 12345 --limit 10

Required flags:

• --project-id — Project ID

Optional flags:

• -e, --environment — Filter by environment name
• --local-user — Filter by deploying user
• --created-after — Unix timestamp for start of range
• --created-before — Unix timestamp for end of range
• --limit — Maximum results (default: 25, max: 25)
• -o, --output — Output format: table or json (default: table)

Get deployment details

hb deployments get --project-id 12345 --id 67890

Required flags:

• --project-id — Project ID
• --id — Deployment ID

Optional flags:

• -o, --output — Output format: text or json (default: text)

Delete a deployment

hb deployments delete --project-id 12345 --id 67890

Required flags:

• --project-id — Project ID
• --id — Deployment ID