| sidebar_position | 15 |
|---|---|
| title | 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.
atomic org show [SLUG] [--org <ORG>] [--format table|json]
atomic org create <NAME> [--email <EMAIL>]
atomic org set <SLUG> [--no-verify]
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>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 set acme
atomic org showShow the current organization or a specific organization.
atomic org show
atomic org show acme
atomic org show --format jsonCreate a team organization. The server derives or validates a URL-safe slug.
atomic org create acme --email team@acme.comSet the default organization for subsequent management commands. The slug is verified against the server before being written to local config, so typos and stale slugs fail fast instead of producing a 404 on the next call.
atomic org set acmeIf the org does not exist on the server, the command errors and leaves the local config unchanged:
✗ Invalid argument: Organization 'acmme' not found on the server.
Check the slug with: atomic org list
Or pass --no-verify to set the value without checking.
Use --no-verify to skip the server check (useful when offline or pointing at
an org that is not yet provisioned):
atomic org set acme --no-verifyUpdate organization metadata.
atomic org update acme --email ops@acme.comDelete an organization. This is destructive and requires confirmation unless
--force is supplied.
atomic org delete acme --force --org acmeUpgrade a personal org to a team org. Takes the org slug to upgrade
(defaults to the resolved default org); --org overrides the organization
used by the API client.
atomic org upgrade acme
atomic org upgrade # operates on the default orgBefore 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.
atomic org member list --org acme
atomic org member list --org acme --format jsonAdd 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 acmeatomic org member update bob@acme.com --role member --org acmeatomic org member remove bob@acme.com --force --org acme| Role | Description |
|---|---|
owner |
Full organization control |
admin |
Manage organization resources and members |
member |
Collaborate in the organization |