Deployments.ai Docs
Command reference

deployments app-grant

Member roles on an app beyond its organization-wide access

CommandSummary
deployments app-grant listList an app's member grants
deployments app-grant setGrant an organization member viewer or editor on an app
deployments app-grant removeRemove a member's grant on an app

deployments app-grant list

List an app's member grants.

deployments app-grant list <app-id>
  • Calls GET /v1/apps/{appId}/grants (SDK listAppGrants).
  • 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
<appId>positionalyesApp ID

Also accepts the global flags.

deployments app-grant set

Grant an organization member viewer or editor on an app.

deployments app-grant set <app-id> <principal-id> --role <role>
  • Calls PUT /v1/apps/{appId}/grants/{principalId} (SDK putAppGrant).
  • 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
<appId>positionalyesApp ID
<principalId>positionalyesMember principal ID
--rolestringyesviewer or editor

Also accepts the global flags.

deployments app-grant remove

Remove a member's grant on an app.

deployments app-grant remove <app-id> <principal-id>
  • Calls DELETE /v1/apps/{appId}/grants/{principalId} (SDK removeAppGrant).
  • 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
<appId>positionalyesApp ID
<principalId>positionalyesMember principal ID

Also accepts the global flags.

On this page