Manage projects
Create a project, choose its region, and switch between projects.
A project isolates data within your organization: logs, threads, issues, and keys are all scoped to a project. Create one per environment or service you want to keep separate. Creating a project takes about a minute.
Create a project
- Open the project switcher and choose to create a project.
- Give it a name and select a region (see below). You should see the new project become active once it is created.
- The project provisions its storage; log ingestion and queries become available shortly after.
Create and switch projects with the CLI (install and authenticate per /reference/cli). The region is set at creation with --region and defaults to us-west-2.
sazabi projects create --name "My Project" # Create in the default region (us-west-2)
sazabi projects create --name "EU App" --region eu-central-1 # Create in a specific region
sazabi projects list # List projects in the active organization
sazabi projects use <project-id> # Set the active project for future commandsThe project provisions its storage after create; log ingestion and queries become available shortly after.
Choosing a region
A project's region determines where its data is stored and processed. The region is fixed at creation and cannot be changed — to move data to a different region, create a new project in that region.
Choose a region for two reasons:
- Data residency — pick a region that satisfies your residency requirements. For EU data, choose a European region.
- Latency — pick a region close to your log sources.
The default region is us-west-2. Sazabi supports additional US and European regions; the project creation screen shows the current list, which today includes us-east-1, us-east-2, us-west-1, us-west-2, and several European regions such as eu-central-1 and eu-west-1. If you need a region that is not offered, contact support.
Security model
A project is a shared environment. Everything you connect or expose to it — log sources, sandbox CLI credentials, MCP connectors, linked repositories — is usable by everyone with access to the project: any member can ask the agent questions that read that data and exercise those tools. Grant project access accordingly, prefer least-privilege or read-only credentials when connecting CLIs and connectors, and restrict access to sensitive projects — see Access control.
Rename and switch
Rename a project under Settings > Project. Switch between projects with the project switcher; commands and dashboard views apply to the active project.
Verify
- Create a project and note the region you chose.
- Confirm it appears in the project switcher and is the active project.
- Open Settings > Project and confirm the region shown matches what you selected.