up0 deploy

Report deployments to up0 (CI-facing)

`up0 deploy create`

Report a deployment starting. Prints the deployment id on success and exits non-zero on failure — the one line a pipeline needs before a release.

Usage: up0 deploy create [OPTIONS]

Name	Type	Default	Description
`--service`	string	required	Service name
`--version`	string	required	Deployed version or tag
`--commit`	string	required	Commit SHA
`--environment`	string	required	Environment name
`--started-at`	string	-	ISO 8601 deploy start time (default: now) — set this to the real build/deploy start, not the time this command happens to run
`--idempotency-key`	string	-	Dedup key for retries. Defaults to the CI run id when a recognised CI environment is detected (GitHub Actions, GitLab CI, CircleCI, Buildkite); required otherwise
`--json`	boolean	false	Emit the full deployment as JSON
`--org-id`	string	-	Organization ID (or set UP0_ORG_ID) (env: `UP0_ORG_ID`)

Report a deployment finishing. The one line a pipeline needs after a release.

Usage: up0 deploy finish [OPTIONS] DEPLOYMENT_ID

Name	Type	Default	Description
`DEPLOYMENT_ID`	string	required	Deployment id from `deploy create`
`--status`	choice (succeeded, failed, rolled_back)	required	Terminal status
`--finished-at`	string	-	ISO 8601 finish time (default: now)
`--json`	boolean	false	Emit the full deployment as JSON
`--org-id`	string	-	Organization ID (or set UP0_ORG_ID) (env: `UP0_ORG_ID`)

List deployments, with the same filters GET /api/v1/deployments itself takes.

Usage: up0 deploy list [OPTIONS]

Name	Type	Default	Description
`--page`	integer	1	Page number
`--per-page`	integer	20	Items per page (max 100)
`--service`	string	-	Filter by service name
`--environment`	string	-	Filter by environment
`--status`	string	-	Filter by status
`--json`	boolean	false	Emit deployments as JSON
`--org-id`	string	-	Organization ID (or set UP0_ORG_ID) (env: `UP0_ORG_ID`)