Skip to main content
Groups allow you to organize users and control access to resources within an organization.

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
—org stringOrganization ID
—jsonEmit the full JSON payload (mutually exclusive with -q)
-q, —query stringArrayjq filter for value extraction (see Query output with -q)

get

Get details for a specific group.

Flags

FlagDescription
—id stringGroup ID
—org stringOrganization ID
—jsonEmit the full JSON payload (mutually exclusive with -q)
-q, —query stringArrayjq 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
—org stringOrganization ID
-f, —file stringPath to a JSON file
—stdinRead JSON from standard input
—dry-runPreview the request payload without persisting
-y, —yesAutomatically confirm creation
—jsonEmit the full JSON payload (mutually exclusive with -q)
-q, —query stringArrayjq filter for value extraction (see Query output with -q)

Examples


update

Update an existing group.

Flags

FlagDescription
—id stringGroup ID
—org stringOrganization ID
-f, —file stringPath to a JSON file
—stdinRead JSON from standard input
—dry-runPreview the request payload without persisting
-y, —yesAutomatically confirm update
—jsonEmit the full JSON payload (mutually exclusive with -q)
-q, —query stringArrayjq filter for value extraction (see Query output with -q)

Examples


delete

Delete an existing group.

Flags