Cloud CLI: Organizations Commands
Execute mcloud organizations commands to list and retrieve Cloud organizations.
Constraints
organizations listrequires personal auth (browser login or personal access key). Organization access keys return 401 on this command.- When authenticated with
MCLOUD_TOKENusing an org access key, usemcloud whoami --jsonto get the organization ID instead.
Commands
organizations list
List all organizations your account has access to.
bashmcloud organizations list --json
Options:
--json— Output as JSON
organizations get
Retrieve a single organization by ID. Returns metadata, subscription details, and members.
bashmcloud organizations get <organization-id> --json
Arguments:
organization— Organization ID (required)
Options:
-o/--organization <id>— Override the organization in active context (must match the argument)--json— Output as JSON
Organization Fields (JSON)
| Field | Description |
|---|---|
id | Organization ID |
name | Organization display name |
billing_email | Billing contact email |
status | active or otherwise |
members | Array of member objects with id, role, user.email |
subscription | Current plan, period, and is_active flag |
account_holder | Billing account holder details |
Examples
bash# List all organizations mcloud organizations list --json # Set context to first organization ORGANIZATION_ID=$( mcloud organizations list --json \ | jq -r '.[0].id' ) mcloud use --organization "$ORGANIZATION_ID" # Find organization ID by name ORGANIZATION_ID=$( mcloud organizations list --json \ | jq -r '.[] | select(.name == "My Organization") | .id' ) # Get organization details (subscription, members) mcloud organizations get org_123 --json # List member emails mcloud organizations get org_123 --json \ | jq -r '.members[].user.email' # Check subscription plan mcloud organizations get org_123 --json \ | jq '{plan: .subscription.plan.name, status: .subscription.is_active}'

