Spaces
Organizing jobs with spaces
Spaces
Spaces are the top-level container for jobs. Each space belongs to an organization and acts as an isolated queue with its own jobs, tokens, and event stream.
Creating a Space
- Go to your organization in the dashboard
- Click Create Space
- Enter a name (e.g.,
production,staging,email-jobs)
How Spaces Isolate Work
- API keys are space-scoped — a token created for
productioncannot access jobs instaging - Workers poll from a specific space — each worker targets one space's queue
- WebSocket streams are per-space — subscribe to all events in a space, or drill down to a single job
- Each space has its own dispatch queue — jobs in one space don't affect processing in another
Naming Patterns
| Pattern | Examples | When to use |
|---|---|---|
| By environment | production, staging, dev | Same job types across environments |
| By job type | emails, video-processing, exports | Different job types with different workers |
| By team/customer | team-billing, customer-acme | Multi-tenant or team-based isolation |
Choose whatever makes sense for your setup. You can always create more spaces later.