Deployments.ai Docs
Command reference

deployments directory

SCIM directory sync, which provisions organization members from an identity provider

CommandSummary
deployments directory showShow directory sync, its tokens, and the SCIM base URL to give the identity provider
deployments directory setTurn on directory sync or change the role it grants provisioned members
deployments directory token createCreate a SCIM bearer token; it is shown only in this response, so pass --reveal
deployments directory token revokeRevoke a SCIM bearer token

deployments directory show

Show directory sync, its tokens, and the SCIM base URL to give the identity provider.

deployments directory show
  • Calls GET /v1/directory (SDK getDirectory).
  • Needs an organization: --org or the saved context.

Also accepts the global flags.

deployments directory set

Turn on directory sync or change the role it grants provisioned members.

deployments directory set --default-role <default-role>
  • Calls PUT /v1/directory (SDK putDirectory).
  • Needs an organization: --org or the saved context.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
FlagTypeRequiredDefaultDescription
--default-rolestringyesRole for provisioned members: member or viewer

Also accepts the global flags.

deployments directory token create

Create a SCIM bearer token; it is shown only in this response, so pass --reveal.

deployments directory token create
  • Calls POST /v1/directory/tokens (SDK createDirectoryToken).
  • Needs an organization: --org or the saved context.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
  • Output contains secrets. They are redacted unless you pass --reveal.

Also accepts the global flags.

deployments directory token revoke

Revoke a SCIM bearer token.

deployments directory token revoke <id>
  • Calls DELETE /v1/directory/tokens/{id} (SDK revokeDirectoryToken).
  • Needs an organization: --org 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

Also accepts the global flags.

On this page