SOLWYN

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.

  1. Open Projects and select New Project.
  2. Set the name, budget limit, period, and mode in the modal.
  3. 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:

TabWhat it holds
CostsSpend over time, by model, provider, day, or agent run, with the cost-events table. See Reading cost views.
AgentsEvery agent run the SDK reported — lifetime cost, denied cost, velocity flags — and the Stop button that ends a runaway run. See Agent runs.
Budget & AlertsThe 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.
ProvidersPer-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.
WebhooksSigned 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.

Next

On this page