Skip to main content

atomic org

Manage Atomic Storage organizations and organization members.

Organizations are the top-level collaboration boundary for hosted Atomic projects. An organization owns workspaces, projects, teams, and membership. Management commands authenticate with your current default identity; --org selects the organization domain/subdomain to operate on.

Synopsis​

atomic org show [SLUG] [--org <ORG>] [--format table|json]
atomic org create <NAME> [--email <EMAIL>]
atomic org switch <SLUG>
atomic org update <SLUG> [--name <NAME>] [--email <EMAIL>]
atomic org delete <SLUG> --force [--org <ORG>]
atomic org upgrade <SLUG> [--org <ORG>]
atomic org member <COMMAND>

Common workflow​

atomic identity new alice-acme --email alice@acme.com --set-default
atomic identity register https://atomic.storage

atomic org create acme --email team@acme.com
atomic org switch acme
atomic org show

Commands​

org show​

Show the current organization or a specific organization.

atomic org show
atomic org show acme
atomic org show --format json

org create​

Create a team organization. The server derives or validates a URL-safe slug.

atomic org create acme --email team@acme.com

org switch​

Set the default organization for subsequent management commands.

atomic org switch acme

org update​

Update organization metadata.

atomic org update acme --email ops@acme.com

org delete​

Delete an organization. This is destructive and requires confirmation unless --force is supplied.

atomic org delete acme --force --org acme

Organization members​

Before adding a developer to an organization, the developer should have a registered identity associated with the organization's email domain, such as bob@acme.com. If the server requires email/domain verification, complete that verification first so the member can be resolved by email.

org member list​

atomic org member list --org acme
atomic org member list --org acme --format json

org member add​

Add a registered identity to an organization. In production, use a verified organization-domain email address such as bob@acme.com. The identity can also be a UUID or name when the server can resolve it.

atomic org member add bob@acme.com --role member --org acme
atomic org member add bob@acme.com --role admin --org acme

org member update​

atomic org member update bob@acme.com --role member --org acme

org member remove​

atomic org member remove bob@acme.com --force --org acme

Roles​

RoleDescription
ownerFull organization control
adminManage organization resources and members
memberCollaborate in the organization