Skip to main content

Teams

Share one balance and one bill with the people you work with.

How teams work

Every Nunchux account is a team. When you sign up, you get your own team, listed as “Your team” in the account switcher. It holds your credits, and you are its admin. A team you create is a separate account. It has its own credit balance, billing, API keys, plan, and rate limits. Nothing moves between your own team and a team you create. The dashboard calls a team an organization in some places, such as the ORGANIZATION section of the sidebar and the Organization Settings page.

Create a team

1

Open the account switcher

In the dashboard sidebar, select the account name under the logo.
2

Select Create team

Give the team a name, then create it.
The new team becomes the active team, and the dashboard opens its Organization Settings page. You are its admin. A new team starts with no credits. Before anyone uses it, add credits or redeem a promo code.

Invite members

1

Open Members

With the team active, select Members under ORGANIZATION in the sidebar, or go to Members.
2

Send the invite

Select the invite button, enter the person’s email address, choose a role, and select Send invite.
The person gets an email invitation. Once they accept it, the team appears in their account switcher. Until then, the invitation is listed on the Members page, where an admin can revoke it.

Roles

A team has two roles: Admin and Member. An admin can change a member’s role on the Members page. Only the person who created a key can rotate it, even on a team where an admin manages every key.

Switch teams

Open the account switcher in the sidebar and select a team. A check marks the active team. The dashboard, the playground, and the keys you create from then on use that team.

Who pays for usage

  • A request from the playground or the dashboard bills the active team.
  • An API key bills the team that was active when the key was created. It keeps billing that team, whoever sends the request and whichever team is active later. The key creation window names the team the key bills.
  • GET /v1/credits with a team’s key returns that team’s balance and caps. Every key billed to a team shares the team’s rate limits.
Switching teams does not move a key or its usage. To bill a different team, switch to it and create a new key there.

Remove a member or delete a team

An admin removes a member from the Members page. Removing a member revokes every API key they created on the team. A member cannot leave a team on their own; ask an admin to remove you. An admin deletes a team from Organization Settings. Deleting a team cannot be undone:
  • Any remaining balance is forfeited. It does not move to another team.
  • Every API key billed to the team stops working.
  • Every member loses access.