Identity CLI Command Reference

Every dcloud iam command. The shape is dcloud <service> <resource> <verb>; every command also takes the global flags (--json, --profile, --dry-run, …).

dcloud iam users

IAM principals — humans and service accounts

dcloud iam password-policy

The organization's rules for IAM-user console passwords

  • getShow the password policy and the org sign-in URL
  • updateSet the password policy (the whole policy)
  • deleteReturn the password policy to the defaults

dcloud iam cli-auth-policy

The organization's CLI sign-in policy: Touch ID or a passkey for people, and personal access key age

  • getShow the CLI sign-in policy
  • dry-runShow who and what a proposed policy would affect, changing nothing
  • updateSet the CLI sign-in policy

dcloud iam groups

Collections of users that share policies

dcloud iam roles

Named policy bundles assignable to users

  • listList roles
  • createCreate a role
  • getDescribe one role
  • deleteDelete a role
  • attach-policyAttach a policy to a role
  • detach-policyDetach a policy from a role
  • set-trust-policySet which federated workloads (e.g. GitHub Actions jobs) may assume a role
  • trust-ciLet this platform's CI assume the role wherever it trusts GitHub Actions, for the repositories imported or mirrored here
  • list-sessionsList the federated sessions issued for a role
  • revoke-sessionsInvalidate every temporary credential issued for a role

dcloud iam oidc-providers

External OIDC issuers (GitHub Actions, …) whose tokens roles can trust

  • listList identity providers
  • createRegister an identity provider
  • getDescribe one identity provider
  • updateChange the accepted audiences
  • deleteRemove an identity provider

dcloud iam sso-connections

The company identity provider people sign in to the console through (OIDC or SAML)

  • listList single sign-on connections and their domains
  • createConnect an OIDC or SAML identity provider (created switched off)
  • getDescribe one connection, with the values to enter at the identity provider
  • updateChange settings, turn the connection on or off, or enforce it
  • deleteRemove a connection; accounts it created stay members
  • add-domainClaim an email domain; returns the TXT record that proves it
  • verify-domainLook up the TXT record and mark the domain verified when it matches
  • remove-domainRemove a domain; a connection left without a verified one is switched off
  • group-mappingsThe IdP group → IAM group mappings and the claim groups are read from
  • set-group-mappingsReplace the IdP group → IAM group mappings
  • scim-tokensList the SCIM provisioning tokens of a connection, and the SCIM base URL
  • create-scim-tokenCreate a SCIM token for the IdP; the token is returned once
  • delete-scim-tokenRevoke a SCIM token

dcloud iam policies

Allow/Deny documents evaluated on every request

  • listList policies
  • createCreate a customer-managed policy
  • getDescribe one policy
  • updateUpdate a policy document
  • deleteDelete a policy
  • simulateTest whether a user, role or draft policy allows an action, and why

dcloud iam grants

Capabilities granted on one resource — the Access panel’s half of policy

  • listList the grants that exist on one resource
  • createGrant capabilities on one resource to a user, group or role
  • revokeTake a grant back and delete the policy it created

dcloud iam access-keys

Long-lived credentials for the API, the CLI, Terraform and S3 clients, optionally capped by a scope policy

  • listList access keys, optionally for one IAM user
  • createCreate an access key and return its secret once
  • set-expiryGive every key of the organization that never expires an expiry
  • set-statusActivate or deactivate an access key
  • deleteDelete an access key

dcloud iam agent-sessions

AI agents connected to the MCP endpoint: what each session may do

  • listList agent sessions, calls waiting for approval and the agent settings
  • set-scopeAllow an agent session to write or destroy for a while, or drop it to read-only
  • approve-callApprove one destructive call an agent planned
  • endEnd an agent session; the agent starts over read-only
  • revoke-connectionRevoke the connection behind a session: OAuth app disconnected, access key refused by MCP
  • update-settingsSet the agent rate limits, or switch off changes by every agent

dcloud iam members

Organization membership and org-level roles

  • listList organization members
  • set-roleChange a member org role
  • removeRemove a member from the organization
  • sessionsList a member's console sessions: device, address, sign-in method
  • revoke-sessionsSign a member out of the console everywhere and disconnect their apps

dcloud iam invitations

Pending invites to join the organization

  • listList invitations
  • createInvite someone to the organization
  • linkGet the link of a pending invitation, to pass on yourself
  • resendSend a pending invitation again; the link gets 7 more days
  • cancelCancel a pending invitation

dcloud iam audit-logs

Every write, denial, sensitive read and sign-in: who, from where, what, and how it was answered

  • listSearch audit log entries, newest first
  • getOne audit log entry with its session context, request and response
  • exportDownload every matching entry, oldest first, as JSON lines or CSV
  • verifyRecompute the hash chain and check the signed digests and the head
  • digestsThe hourly Ed25519-signed digests of the chain head, and the public keys
  • get-settingsHow long entries are kept
  • update-settingsSet how long entries are kept, 90 to 3650 days

dcloud iam audit-destinations

Where the audit log is exported (S3, webhook, syslog) and the alarms on it (email)

  • listList exports and alarms with their delivery state
  • getOne export or alarm: cursor, last delivery, last error
  • createExport to S3, a webhook or syslog over TLS, or alarm by email on matching events
  • updateRename, pause, resume, change the filter, or replay from the start or skip to now
  • deleteRemove an export or alarm
  • testSend one synthetic event now and report what the destination answered

Generated from the API description, the same one the API checks requests against and the CLI is built from.