boxd auth org and boxd teams on the CLI, and from the SDKs’ orgs and teams namespaces.
Roles
Create an org and manage its roster
- Invites carry a role. The invitee lands as
memberoradmin, and an admin invite can only be sent from an interactive login. An API key or a token minted inside a machine cannot send one, and cannot read the links of pending invites either. It still sees that an invite is pending. - Demoting another admin is owner-only. An admin can always demote themselves.
- The owner’s role is fixed. It cannot be changed with
set-role, and an owner or admin cannot be removed withremove-member. Both go through the boxd team. - A member who still owns org-billed machines cannot be removed. Move those machines to their owner’s default org or delete them first.
- Org API keys outlive the person who made them. A
--kind orgkey keeps working after its maker leaves, so CI doesn’t break when someone moves on. Every admin sees the org’s org keys, with who made each one, inboxd auth keys listand on the console’s API keys page, and can revoke them. When someone leaves, check the keys they made. See API keys.
boxd auth switch acme first, or pass --org acme for one call.
Teams
A team is a group of members inside an org, with an optional default snapshot. A machine created by a team member is created from that snapshot unless they pick another one, which is how a team hands every new machine the same starting point. See Snapshot your app.Create a machine for a member
An owner or admin can create a machine that belongs to another member from the start, ready to work: their team’s snapshot, the packages and secrets they need, and their own integrations and agent logins. It takes a machine spec withassignTo, from the SDKs or the API:
Regions
Every org runs machines in both Frankfurt and New York. Members, roles, teams, secrets and billing are the same in both. Owners and admins set the org’s default region, where new machines go when nobody picks one.boxd teams set-default-snapshot backend base.nyc sets the one new team machines in New York start from. See Regions.