list-deployments

List deployments with the Unkey API CLI

List deployments with optional resource and lifecycle status filters.

Usage

unkey api deployments list-deployments [flags]

Flags

--project · string

Project identifier or slug.

--app · string

Application identifier or slug.

--environment · string

Environment identifier or slug.

--status · string[]

Comma-separated lifecycle statuses. Valid choices are pending, starting, building, deploying, network, finalizing, ready, failed, skipped, awaiting_approval, stopped, superseded, and cancelled.

--limit · integer

Maximum deployments to return per page. The default is 100.

--cursor · string

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

Basic

unkey api deployments list-deployments --project=payments --app=payments-api --environment=production --status=ready,failed

See the List deployments API reference.