Skip to content
ATLAS
 Docs
On this page

Split a Team budget between members#

Share a Team's monthly budget between its members, and set daily and weekly spend limits per member.

Before you begin#

  • You need the Owner or Admin role, or you manage the Team or a space above it. Roles and permissions lists what each role can do.
  • Only Teams can split budgets. Divisions and Units can't.
  • The Team already has a monthly budget. If it doesn't, set one first with Set a space budget.

Choose how the budget is shared#

  1. In the sidebar, open Spaces and select the Team.
  2. Open the Budget tab and find the allocation mode cards.
  3. Under Allocation mode, choose one of:
    • Pool: everyone draws from one shared monthly budget.
    • Fixed: each member gets a fixed euro amount. The amounts can't add up to more than the Team budget.
    • Proportion: the budget is split by percentage. The shares must add up to exactly 100.
  4. For Fixed or Proportion, enter a value for each member. Members without a value are blocked and flagged as unallocated.
  5. Select Save allocations.

To give one person a different share, open the People tab, open the row's action menu and select Edit allocation & limits.

Switching mode discards the existing per-member values. ATLAS asks you to confirm in the Switch allocation mode? dialog.

Set member spend limits for the Team#

  1. On the Budget tab, find Allocation & limits.
  2. Enter a default daily limit, a default weekly limit, or both. Each must be greater than zero, and an empty field means unlimited.
  3. To change one person, open the People tab, open the row's action menu and select Edit allocation & limits. The override can be higher or lower than the default. Remove it to return to the default.
  4. Save.

The day starts at midnight and the week on Monday at midnight, in the business time zone. Members see their own usage and reset times. A member who reaches a limit gets 429 budget_exceeded naming the window and reset time.

To freeze a Team, set its monthly budget to 0 instead.

For projects, project managers, account managers and organisation admins set the same limits on the project's Limits tab. Per-member overrides are in the Members table, under Edit spend limits. They apply to personal keys acting under the project only.

Check how members are doing#

Open the People tab. The budget column shows each member's utilisation. It uses the normal text colour below 80%, amber from 80%, and red at 100% or more. A dash means no limit, and a blocked member shows no allocation.

Result#

Once a member's share or a Team limit is used up, the gateway refuses that member's requests with a 429 budget error (402 for Anthropic-compatible clients). Days and months follow the organisation's business time zone.

When membership changes#

  • Proportion: removing a member rescales the others so they add up to 100. A new member starts at 0% until you redistribute.
  • Fixed: removing a member frees their amount. A new member starts at €0 until you allocate.

Troubleshooting#

Look up any code in the error catalogue. Errors explains how ATLAS reports them.

Cause Code What to do
Fixed amounts add up to more than the Team budget ERR-0051 Lower the amounts or raise the Team budget
Proportion shares do not add up to exactly 100 ERR-0052 Adjust the shares until they total 100
Values were entered while the mode is Pool ERR-0053 Choose Fixed or Proportion, or clear the values
The Team has no monthly budget ERR-0054 Set a space budget first
You tried to split the budget of a Division or Unit ERR-0057 Open a Team. Only Teams can split budgets