Organizations

crab org create acme --plan scale
# Complete payment at the printed URL before deploying.
crab --org acme deploy

• An org is its own account, with a handle of its own: its services, API keys, apps, plan and credit belong to it, and it is billed apart from its members' accounts.
• Make one under Settings → Organizations, or with crab org create <handle>, --name for its display name. Whoever makes it is its first owner. Hobby is free; additional organizations require Scale.
• crab org ls lists the orgs you belong to, and crab org info <org> one of them, as much as you may see.
• crab org update <org> --handle <handle> --name <name> renames it.

Roles

• An org always has an owner: the last one cannot be removed or made a member.
• crab org members <org> lists its members. crab org role <org> <member_id> --owner makes a member an owner, and --member an owner a member. crab org remove <org> <member_id> removes one, or, with your own id, leaves.

Adding people

crab org invite acme [email protected]
crab invites accept <token>

• crab org add <org> <email> adds someone who already has an account, at once. --owner adds them as an owner.
• crab org invite <org> <email>, or the org's settings → Members, invites an address, as a member or with --owner as an owner. No email is sent: crab prints a token to send them.
• The invite appears under Settings → Organizations for whoever signs in with that address, and crab invites accept <token> accepts it from the terminal. An account made with that address joins at its first sign-in.
• An invite lasts 14 days. Inviting the same address again starts a new one. crab org invites <org> lists the pending ones, and crab org uninvite <org> <token> revokes one.

Acting for an org

• --org <org>, by handle or id, makes any command act for the org in place of your own account: crab --org acme billing, crab --org acme deploy.
• A context can act for an org by default: crab context add <name> https://api.crabtalk.ai --token-stdin --org <org>, with a key made on the org. See Contexts.
• A key made on an org acts on the org alone. See API keys.

Plans

• Each account can sponsor one Hobby organization with up to three members, including owners and unexpired invitations. The sponsor must remain an owner. An owner can transfer sponsorship to another owner who has an available free slot, from Members or with crab org sponsor <org> <member_id>.
• Hobby organizations cannot verify on GitHub or receive Trial credit. Hosting requires Scale or a comped entitlement.
• Scale costs $50/month with unlimited members. Its services and members share one set of resource budgets and one $10 Credit return per paid period. Scale is also available to individuals. See Plans.
• Additional organizations require their own Scale subscription. Credit and Trial credit cannot move between accounts.

Creation and payment

Select Hobby or Scale under Settings → Organizations, or create a paid org with crab org create acme --plan scale. Paid creation reserves the handle for 30 minutes and activates the organization after successful payment. Each person can have one pending org checkout. A pending checkout can be resumed from Organizations; an expired, unpaid checkout releases its handle after payment status is reconciled.

Cancellation and recovery

At the paid term's end, an organization can become Hobby if its designated sponsor has a free slot and it has at most three members and pending invitations. Otherwise it pauses for 30 days from the end of paid access. During that window, subscribe to Scale or qualify for Hobby to keep the organization. Members are not removed automatically.

After recovery expires, services and data are deleted, keys revoked and the handle released. Historical records retain the original account ID. Subscription refunds are handled manually by email.

Deleting an org

• An owner deletes it under its settings → Profile, or with crab org rm <org>.
• Deleting is refused while its subscription can still bill.
• A deleted org's page is gone, and its keys stop working. Its handle is held for 30 days before release. A deleted Hobby org keeps its sponsor's free slot occupied during that reservation.