gabrielmoreira 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.
mcloud organizations list --json
Options:
--json— Output as JSON
organizations get
Retrieve a single organization by ID. Returns metadata, subscription details, and members.
mcloud 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
# 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}'