Deployments.ai Docs
Command reference

deployments release

Immutable agent releases

CommandSummary
deployments release listList releases for an agent definition
deployments release showShow an agent release
deployments release archiveArchive an agent release
deployments release promotePromote an agent release into another environment

deployments release list

List releases for an agent definition.

deployments release list <id>
  • Calls GET /v1/agent-definitions/{id}/releases (SDK listAgentReleases).
  • Needs an environment: --env or the saved context.
  • Paginated. --page-size sets the page size; pass the returned cursor as --cursor for the next page.
FlagTypeRequiredDefaultDescription
--cursorstring (cursor)Pagination cursor
--page-sizestring (number)Page size
<id>positionalyesResource ID

Also accepts the global flags.

deployments release show

Show an agent release.

deployments release show <id>
FlagTypeRequiredDefaultDescription
<id>positionalyesResource ID

Also accepts the global flags.

deployments release archive

Archive an agent release.

deployments release archive <id> --expected-version <number>
  • Calls DELETE /v1/agent-releases/{id} (SDK archiveAgentRelease).
  • Needs an environment: --env or the saved context.
  • Destructive. Live runs ask for confirmation; pass --yes in scripts or with --json.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
FlagTypeRequiredDefaultDescription
<id>positionalyesResource ID
--expected-versionstring (number)yesExpected resource version

Also accepts the global flags.

deployments release promote

Promote an agent release into another environment.

deployments release promote <id> --target-environment <target-environment>
  • Calls POST /v1/agent-releases/{id}/promote (SDK promoteAgentRelease).
  • Needs an environment: --env or the saved context.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
FlagTypeRequiredDefaultDescription
<id>positionalyesResource ID
--target-environmentstringyesTarget environment ID

Also accepts the global flags.

On this page