Skip to main content
Groups allow you to organize users and control access to resources within an organization. Commands that act on one group take its ID either as a positional argument or with --id. If you omit it, the CLI opens an interactive picker, so always pass it in scripts.

​
Subcommands

  • list — List groups
  • get — Get group details
  • create — Create a new group
  • update — Update an existing group
  • delete — Delete a group

​
list

List groups in an organization.

​
Flags

FlagDescription
Organization ID
Emit the full JSON payload (mutually exclusive with -q)
jq filter for value extraction (see Query output with -q)

​
get

Get details for a specific group.

​
Flags

FlagDescription
Group ID
Organization ID
Emit the full JSON payload (mutually exclusive with -q)
jq filter for value extraction (see Query output with -q)

​
create

Create a new group in the specified organization. Supports interactive mode or JSON input.

​
Flags

FlagDescription
Organization ID
Path to a JSON file
Read JSON from standard input
Preview actions and payload without persisting
Automatically confirm creation
Emit the full JSON payload (mutually exclusive with -q)
jq filter for value extraction (see Query output with -q)

​
Examples

​
update

Update an existing group.

​
Flags

FlagDescription
Group ID
Organization ID
Path to a JSON file
Read JSON from standard input
Preview actions and payload without persisting
Automatically confirm update
Emit the full JSON payload (mutually exclusive with -q)
jq filter for value extraction (see Query output with -q)

​
Examples

​
delete

Delete an existing group.

​
Flags