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 or name 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. Aliases: list, ls

​
Flags

FlagDescription
Organization ID or name
Emit the full JSON payload (mutually exclusive with -q)
jq filter for value extraction (see Query output with -q)
Show at most N results (client-side; every result is still fetched). Cuts before -q. 0 for all

​
get

Get details for a specific group.

​
Flags

FlagDescription
Group ID or name
Organization ID or name
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 or name
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 or name
Organization ID or name
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. Aliases: delete, rm, remove

​
Flags

​
Examples