Make an organisation
Choose New organisation in the organisation menu and name it. You become its owner. Your account must be off the waitlist, and you must have signed in with a code sent to your address. A new organisation has no credit, and its tier comes from its own purchases. Buy credit in Billing before its first decision.Invite people
- In Organisation settings, on the Members tab, choose Invite member and pick a role.
- We email the invitation. It stays open for 14 days.
- They sign in with that address, which creates an account if they have none, and accept it in Invitations.
Roles
Only owners manage members and invitations, and rename or delete the organisation. Owners and billing members choose where the bills go and which emails come. The console shows each role only the pages it can use.
An organisation always has an owner. The last owner can’t leave, change role or delete their account until someone else is an owner.
Keys in an organisation
A key works only in the organisation it was made in, with the role it was made with. That role is at most its maker’s: owners make keys of any role, developers make developer keys, and billing members make none. Owners can revoke any key, developers only their own.GET /v1/account/keys shows each key’s role and made_by, the member who made it. In your personal organisation, every key’s role is owner.
A call needs both the key’s access and its role to allow it. A route the role doesn’t allow, such as the wallet for a developer key, gets 403 role_forbidden.
A key stops working while its maker is suspended (403 account_blocked).
In GET /v1/account, a shared organisation’s key sees the organisation, not its maker. user.email is the billing email, or null for a developer key, and referrals is null.
When someone leaves or changes role
The console lists the keys that will stop before you confirm. Someone who rejoins keeps no key above their new role.
A kept key works on after its maker deletes their account. If an organisation needs your keys, ask an owner to remove you and keep them before you delete your account.
Someone who goes, or loses billing access, also takes their saved card off the automatic top-up. It stays off until someone adds another card in Billing.
The other owners and billing members get an email when:
- the bills still go to that person
- the person’s keys stopped as they left or deleted their account
- the top-up lost their card
Where the bills go
Bills go to the organisation’s billing email, at first its maker’s address. Owners and billing members can change it in Organisation settings to the address of any owner or billing member who has signed in with a code. The billing email gets invoices, receipts, credit reminders and the organisation’s other account emails. It is a contact, not a role:
Owners and billing members switch Credit reminders and Model updates for the organisation in Organisation settings. An email’s unsubscribe link turns its kind off for the organisation.
