List deployments with optional resource and lifecycle status filters.
Usage#
Flags#
Project identifier or slug.
Application identifier or slug.
Environment identifier or slug.
Comma-separated lifecycle statuses. Valid choices are pending, starting, building, deploying, network, finalizing, ready, failed, skipped, awaiting_approval, stopped, superseded, and cancelled.
Maximum deployments to return per page. The default is 100.
Pagination cursor from a previous response.
Global Flags#
| Flag | Type | Description |
|---|---|---|
--root-key | string | Override root key ($UNKEY_ROOT_KEY) |
--api-url | string | Override API base URL (default: https://api.unkey.com) |
--config | string | Path to config file (default: ~/.unkey/config.toml) |
--output | string | Output format - use json for raw JSON |
--body | string | Send this JSON string as the request body. You cannot combine it with request-building flags. |
Examples#
See the List deployments API reference.