Projects
How projects scope log sources, repos, channels, and analyses inside a tenant
Projects
A project is a logical grouping inside a tenant. Most configuration in SigSentry is project-scoped: log sources, code repos, notification channels, watchdog rules, support desk integrations, API keys, and analyses.
Why projects exist
Most teams manage multiple environments or services that should not share configuration:
prodandstaginghave different log sources- The mobile backend and the web app might point to different repos
- The
customer-successproject might route notifications to a different Slack channel thanengineering
Projects let you keep these isolated without creating multiple tenants.
What's project-scoped vs tenant-scoped
| Project-scoped | Tenant-scoped |
|---|---|
| Log sources | Users + roles |
| Code repos | Subscription + billing |
| Notification channels | Audit log (cross-project) |
| Watchdog rules | Default notification severity |
| Support desk bindings | Connected chat workspaces |
| API keys (when scoped) | API keys (when not scoped) |
| Analyses | — |
| AI analysis context | — |
| Project access list | — |
API keys can be tenant-scoped (work across all projects) or project-scoped (only one project) — see Authentication.
The default project
Every new tenant starts with one default project. You can rename it under Project → General. The default project cannot be deleted — this protects against accidentally orphaning the tenant.
Slugs
Each project has a name (display) and a slug (URL- and
chat-friendly identifier). Slugs are lowercase letters, numbers, and
hyphens. They're scoped to a tenant — prod is unique within your
tenant only.
The slug appears in:
- Dashboard URLs:
/dashboard/projects/<slug>/... - Chat command target:
/sigsentry analyze ... --project=<slug> - API requests via the
X-Project-Idheader (you send the project's ID, not slug, but the slug is the human-readable handle)
Quotas
The number of projects you can have is plan-dependent:
| Plan | Projects |
|---|---|
| Starter | 2 |
| Pro | 5 |
| Business | 20 |
| Enterprise | Unlimited |
Each project also has its own per-resource quotas (log sources, repos, channels, watchdog rules) — see Plans & quotas.
