chainctl
chainctl Chainguard Control
3 min read
For the complete documentation index, see llms.txt.
Update an IAM role.
chainctl iam roles update ROLE_NAME|ROLE_ID [--capabilities=CAPABILITY,...] [--add-capabilities=CAPABILITY,...] [--remove-capabilities=CAPABILITY,...] [--description=DESCRIPTION] [--yes] [--output=id|json|table] # Update a role with a complete set of capabilities
chainctl iam roles update my-role --capabilities=policy.list,groups.list,identity.list
# Add new capabilities to a role
chainctl iam roles update my-role --add-capabilities=policy.create
# Remove an existing capabilities from a role
chainctl iam roles update my-role --remove-capabilities=identity.list
# Interactively choose capabilities to add to a role
chainctl iam roles update my-role --add-capabilities= --add-capabilities strings A comma separated list of capabilities to add to this role (can't be used with --capabilities).
--capabilities strings A comma separated list of capabilities to grant this role.
--description string A description of the role.
--remove-capabilities strings A comma separated list of capabilities to remove from this role (can't be used with --capabilities).
-y, --yes Automatic yes to prompts; assume "yes" as answer to all prompts and run non-interactively. --api string The url of the Chainguard platform API. (default "https://console-api.enforce.dev")
--audience string The Chainguard token audience to request. (default "https://console-api.enforce.dev")
--config string A specific chainctl config file. Uses CHAINCTL_CONFIG environment variable if a file is not passed explicitly.
--console string The url of the Chainguard platform Console. (default "https://console.chainguard.dev")
--force-color Force color output even when stdout is not a TTY.
-h, --help Help for chainctl
--issuer string The url of the Chainguard STS endpoint. (default "https://issuer.enforce.dev")
--log-level string Set the log level (debug, info) (default "ERROR")
-o, --output string Output format. One of: [csv, env, go-template, id, json, markdown, none, table, terse, tree, wide]
-v, --v int Set the log verbosity level.chainctl Chainguard Control
chainctl actions Interact with the Chainguard Actions product.
chainctl actions catalog Browse the public Chainguard Actions catalog.
chainctl actions catalog list List Chainguard Actions in the public catalog.
chainctl actions discover Discover GitHub Actions dependencies used by your workflows.
Last updated: 2026-11-11 10:22