Projects
Create a project, capture its first key, and navigate its five tabs.
A project is Solwyn's unit of budgeting and attribution: one budget, its own costs, alerts, and webhooks. API keys belong to the account and list the projects they reach; every app names its project with SOLWYN_PROJECT. Everything the SDK reports is priced and rolled up per project.
Create a project
Creating a project and setting its budget is a single action — every project is born with a limit, a period, and an enforcement mode.
From onboarding. Getting Started's first step, Create Project, sets the project name, budget limit, period, and enforcement mode in one form.
From the project list.
- Open Projects and select New Project.
- Set the name, budget limit, period, and mode in the modal.
- Create. The project's first API key appears exactly once.
The one-time key reveal
When the project is created, its first key (solwyn_sk_ followed by 64 hex characters) is shown once, in a modal you cannot dismiss by accident. The key holds only this project. Copy it before closing, as the raw key or as ready-to-paste SOLWYN_API_KEY=… and SOLWYN_PROJECT=… lines. Afterwards only its prefix is shown; there is no way to read it again, only to rotate it.
This matches the CLI: solwyn projects create shows the first key once, or stores it on that computer with --store-key. More keys, and every key's projects, are managed under Settings > API keys. See API keys.
Renaming a project
Apps that set SOLWYN_PROJECT to the old name stop working at their next start. Running apps are not affected, because the SDKs pin the project's proj_ id once they start. Apps that use the proj_ id keep working. The rename dialog says so before you confirm.
Inside a project
Opening a project lands on Costs, the default tab. Five tabs cover the project end to end:
| Tab | What it holds |
|---|---|
| Costs | Spend over time, by model, provider, day, or agent run, with the cost-events table. See Reading cost views. |
| Agents | Every agent run the SDK reported — lifetime cost, denied cost, velocity flags — and the Stop button that ends a runaway run. See Agent runs. |
| Budget & Alerts | The budget form (limit, period, mode, thresholds, scoped and runaway-run rules) and the project's delivery defaults. See Budgets. Its Key access card holds Only accept keys dedicated to this project; see Dedicated keys. |
| Providers | Per-provider health: circuit state, success rate, latency. Below it, Surfaces Solwyn does not meter yet — the provider capabilities your code reached that carry no budget check or cost event, from the SDK's advisory reports: surface, client shape, mode, posture, approximate occurrences, first and last seen. Counts are advisory, never billing truth. |
| Webhooks | Signed event delivery to your HTTPS endpoints. See Webhooks. |
Switching projects
The project switcher in the navigation moves between projects; its + New Project shortcut opens the same creation form. The CLI mirrors the list with solwyn projects list.