Skip to main content

Organization

An organization is a shared wallet with its own members, teams and API keys. Its admins invite people, decide how much each member and team can spend, and add the credits. Every member's requests are paid from the organization's credits.

Identities​

One email can be used on its own and inside one or more organizations. Each of these is an identity: Personal, or an organization you belong to. An identity has its own API keys, usage, logs and chat history. Your personal identity has its own wallet; under an organization identity, the organization pays.

To change identity, open Switch identity at the top of the console's sidebar and pick one under Switch to. The console opens on the identity you used last. A Paid by label in Chat and on each API key says which wallet pays.

If your account was created from an organization's invitation, it has no personal identity yet. Choose Open a personal identity in the same menu to get one: a wallet of your own that starts at $0, with its own API keys, usage and history. Your organization identity stays.

Create an organization​

  1. Open Switch identity at the top of the sidebar and choose Create an organization.
  2. Enter an Organization name and choose Create.

You become the organization's admin and the console switches to it. Your personal identity, wallet and keys stay as they are.

  • An account can create up to 3 organizations. To create more, talk to our sales team.
  • Some accounts are asked for a one-time human check first. Choose Verify and create; the organization is created right after it.
  • An organization does not get starter credit. Its first top-up earns the first top-up bonus once.

Invite members​

On the Organization page, under Members, choose Invite member. Enter the person's Email, pick a Role (Admin or Member) and a Team, then choose Send invitation. Everyone in the organization is in a team; the default team is chosen unless you pick another.

The person gets an email with a link to join. The link works for 7 days.

  • Someone new to OceanToken chooses Join and set password. Their account belongs to the organization.
  • Someone who already has an account signs in with the invited email and chooses Join with my account. Joining adds the organization to their account; their own account, balance and keys stay as they are.

The Invitations list shows each invitation's Status: Pending, Joined, Expired or Revoked. Resend sends a new link, and the old one stops working. Revoke cancels an invitation that has not been accepted.

An organization can have up to 100 people, counting members and pending invitations. For a larger team, write to support@oceantoken.ai.

Members and caps​

The Members table lists each member's Email, Role, Teams, usage This month and Cap. Usage is for the calendar month in UTC. Only an organization admin can add, remove or change members; other members see the list.

ActionWhat it does
Set capLimits how much of the organization's credits the member can use: No cap, an amount In total, or an amount Per month. Once the member has used that much, their requests are refused. A monthly cap starts again on the 1st (UTC)
Make admin / Make memberChanges the member's role
TeamsChooses the teams the member is in, at least one
RemoveTakes the member out of the organization. Their API keys under this organization stop working immediately; their personal keys are not affected

Under Organization settings, Default allowance for new members sets the cap that people who join by invitation get from then on. Members already in the organization keep theirs.

Teams​

A team groups API keys. A team's Allocation caps what the API keys in that team can spend of the organization's credits. Chat in the console is not counted toward it. Leave the allocation empty for no cap; to cap a person, use Set cap in Members.

To add a team, enter a New team name and choose Create team. The table shows each team's Allocation and what it has Used. Allocations may add up to more than the organization's credits; spending still stops when those run out.

Rename changes a team's name. Delete removes a team: its API keys keep working and move to the default team, and members who are in no other team move there too. The Default team cannot be deleted.

Organization credits​

The Organization credits card on the Organization page shows three figures:

CardWhat it means
AvailableWhat members can spend now: everything added minus what was used
Added in totalTop-ups and credit from OceanToken
UsedEverything the organization's members and teams used

Add credits to the organization opens the Credits page, where an admin tops up. Enter an Amount to add, from $0.50 to $100,000 each time, and confirm with the button under it, which reads Add $50 for $50. You pay by card on a hosted checkout page, with the same processing fee as a personal top-up. The credits update a few seconds after payment.

The organization has its own tier: it rises with the organization's cumulative top-ups, never goes down, and sets the discount every member's requests get on selected models.

Admins also find the organization's monthly statements on the Credits page, with usage by team and by member.

When the organization has no credit left, members can use only models whose ID ends in :free until an admin adds some.

Members' API keys​

Members' API keys lists the keys members use under this organization, with the Member, Team, Spend and Status of each. Filter the list by member email. Stop makes a key stop working right away; Resume turns it back on.

Models lists the models the organization can use. Contact us if your team needs another model.

What a member sees​

Under an organization identity, a member's console shows the organization's side of things:

  • Credits says Your organization pays for your requests. Your allowance shows your Cap, what you have Used and what is Left; a monthly allowance shows the date it starts again. With No cap, you can use the organization's credits until they run out.
  • Overview shows what you can spend now, within your allowance and the organization's credits.
  • An organization admin can switch Activity from Just me to all of the organization, with Spend by team, and Logs lists requests from everyone, with a Member column.

To get a higher allowance or more credits, ask an organization admin.