Projects
What a project is, how to create and switch between projects, and how project scope works.
A project is a container inside your organization
that holds a related set of connections, agents, workflows, and deployments.
Projects let you separate work — for example staging from production, or one
client's work from another's. You always work within one project at a time.
The default project
Every organization has a Default project, so there's somewhere to work the moment you sign in. It's the organization's own workspace: your Compass role in the organization is your role in Default. Because of that, Default is always there — it can't be renamed, left, or deleted, and it isn't listed with the other projects in Settings. Add as many other projects as you like.
Creating a project
In Studio, click the project's name in the top bar and choose New project — give it a name and it's ready to use. Creating projects takes a Developer or Admin role; names must be unique within the organization. You become the new project's Admin, and Compass switches to it. It starts empty; you add connections, agents, workflows, and datasets to it as you build.
Switching projects
The same menu moves you between projects in the current organization, and Compass remembers your choice when you come back. Studio works in one project at a time: the workflows, agents, connections, and datasets you see and build are always those of the active project. Console looks across every project you can reach, with an All projects filter on Observability and Deployments to narrow it to one.
Editing a project
Open Settings → Organization → Projects and pick a project. Its tabs are:
- General — the project's name and description.
- People — who has access, and with which role. See Members & roles.
- Spend limits — budgets for the project. See Spend limits.
- Danger zone — delete the project, which permanently removes its workflows, deployments, executions, conversations, and connections. You'll type the project's name to confirm, and a project behind a solution can't be deleted. Anyone who isn't an organization admin can also leave the project here; organization admins can't, since their access comes from the organization.
The project's own Admins can change all of this, as can organization admins.