Help

organizations Command - Medusa Cloud CLI Reference

In this guide, you'll learn how to manage your Cloud organizations using the CLI.

organizations list#

List all organizations your account has access to.

Note: If you're authenticated with an access key, you must be using a personal access key to use this command. Organization access keys do not have permissions to list organizations for a user.

Terminal
❯mcloud organizations list

Options#

Option	Description	Default
`--json`	Print the result as JSON instead of formatted text.	`false`

organizations get#

Retrieve a single organization by its ID, handle, or name. Returns the organization's metadata, subscription details, and members.

Terminal
❯mcloud organizations get <organization>

Returns the following information:

Arguments#

Option	Description	Required	Default
`organization`	The ID, handle, or name of the organization to retrieve.	No	Falls back to the organization in the active context, if set.

Options#

Option	Description	Required	Default
`-o <id-handle-or-name>`, `--organization <id-handle-or-name>`	The ID, handle, or name of the organization to retrieve. Interchangeable with the positional argument.	No	Falls back to the organization in the active context, if set.
`--json`	Print the result as JSON instead of formatted text.	No	`false`

Find Organization ID#

Commands that operate on organizations require an organization ID. You can either:

Use the interactive selector in mcloud use to set an active organization for the current context. Once set, you can omit the --organization flag from all subsequent commands;
Or use organizations list --json to get machine-readable organization data. Pipe the output to jq to extract IDs for use in subsequent commands. This is useful if you want to set the active organization through an AI agent, script, or CI/CD pipeline.

For example, to set the first organization in the list as the active organization:

To set the active organization to the ID of an organization by its name:

Once set, you can omit the --organization flag from all subsequent commands.

Was this guide helpful?