TokenSense
Start Free

Projects & Budgets Setup

Projects let you group AI spend by client, department, or use case. Budgets let you cap that spend. This guide walks you through setting both up. For the concepts behind these features, see Projects and Budgets.

Create a project

1

Open Settings → Projects

In the dashboard sidebar, click Settings, then select the Projects tab.

2

Add a new project

Click New Project. Give it a name (e.g., "Client A" or "Marketing"), pick a color for the dashboard charts, and add an optional description.

Assign API keys to a project

3

Keys carry the project tag

When you create a TokenSense API key, you pick which project it belongs to. Every request made with that key is automatically attributed to the project. Go to Settings → API Keys → New Key and select the project from the dropdown.

Set a project budget

4

Configure the budget cap

In Settings → Projects, click on the project and set a monthly budget amount. When spend reaches 80% of the budget, you get an alert. At 100%, requests using that project's keys return a 402 response with budget details, blocking further spend.

Set a workspace budget

5

Cap total spend across all projects

Go to Settings → General and set a workspace-wide budget. This is your safety net — even if individual project budgets are high, the workspace cap prevents total spend from exceeding your limit.

Budget alerts

6

Who gets notified and when

Budget alerts are sent at two thresholds: 80% (warning — spend is approaching the cap) and 100% (requests blocked). Alerts appear in the dashboard action items panel. Workspace owners and admins receive notifications.

Common patterns

Agencies: One project per client. Each client's spend is tracked separately — export the breakdown at month-end for invoicing.

Ops teams: One project per department. Set different budgets based on each team's needs.

Solo builders: Projects are optional. A workspace budget is usually enough to prevent runaway spend.

Related