Deployments.ai Docs
Command reference

deployments service-account

Machine identities

CommandSummary
deployments service-account createCreate a service account
deployments service-account listList service accounts
deployments service-account showShow a service account
deployments service-account revokeRevoke a service account

deployments service-account create

Create a service account.

deployments service-account create --name <name> --scopes <a-b-c>
  • Calls POST /v1/service-accounts (SDK createServiceAccount).
  • 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
--namestringyesResource name
--descriptionstringResource description
--scopesstring (a,b,c)yesCapability scopes

Also accepts the global flags.

deployments service-account list

List service accounts.

deployments service-account list
  • Calls GET /v1/service-accounts (SDK listServiceAccounts).
  • 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

Also accepts the global flags.

deployments service-account show

Show a service account.

deployments service-account show <id>
FlagTypeRequiredDefaultDescription
<id>positionalyesResource ID

Also accepts the global flags.

deployments service-account revoke

Revoke a service account.

deployments service-account revoke <id>
  • Calls DELETE /v1/service-accounts/{id} (SDK revokeServiceAccount).
  • 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
--reasonstringReason for this operation

Also accepts the global flags.

On this page