Skip to content
Menu
Base URLhttps://api.getworg.com/v1

Organization

Who can do what in your organization, how workspaces split keys and budgets, and how to protect your account.

Roles

An organization has three roles: owner, admin and member. It always keeps at least one owner.

ActionWho
Change rolesOwner, with a two-step code
Set the organization's monthly budgetOwner
Invite membersOwner or admin. Only an owner adds another owner.
Remove membersOwners remove anyone, admins remove members. Anyone can leave.
Organization settings, low-balance email, combosOwner or admin
Review, rotate or resume a suspended keyOwner or admin. Resume needs a two-step code.
Credits ledger, monthly statements, referralsOwner or admin
Top upEveryone. Members see only their own orders.
UsageEveryone, for the whole organization
Create keysEveryone. Members get the default limits.

Removing someone revokes the keys they created, and the owners get an email about it.

Workspaces

  • Every organization has a Default workspace. It uses the organization's limits and cannot be archived.
  • Other workspaces can have a monthly budget, up to the organization's budget, and their own requests-per-minute and tokens-per-minute limits.
  • A key's budget cannot be higher than its workspace's budget or the organization's budget.
  • Archiving a workspace revokes every key in it. It cannot be undone.

In each workspace a person is an admin or a developer. Owners and admins of the organization are admins everywhere. A developer creates keys with the default limits and manages only their own keys. Every member is a developer in Default.

Two-step verification

Two-step verification uses an authenticator app. It is optional, and recommended for owners and admins once the organization has a balance. Three actions need it:

  • Resuming a suspended key
  • Changing a member's role
  • Making new recovery codes

Turn it on in Account. You get 10 recovery codes, shown once. A recovery code works for signing in, but not for the three actions above. If you lose both your authenticator and your codes, write to team@getworg.com.

Next: BillingAuthentication