Organizations (Workspaces)
Create and manage workspaces for team collaboration.
In Convoy Cloud, a workspace (organization) is the top-level unit of isolation. Each workspace has its own applications, billing, plan limits, and monitoring — completely isolated from other workspaces.
Creating a workspace
- Click the workspace switcher in the sidebar header.
- Select Create Organization.
- Enter a name for your workspace.
- Convoy Cloud provisions your workspace automatically.
You can create multiple workspaces for different projects, teams, or environments.
Workspace provisioning
When you create a new workspace, Convoy Cloud sets up:
- An isolated Kubernetes namespace for your applications
- LimitRange policies that cap per-app CPU and memory at the plan ceiling
- NetworkPolicy rules isolating your namespace from other tenants
- A Grafana organization with pre-configured dashboards
Your first workspace receives €1.50 in welcome credits. Subsequent workspaces start with no credit.
The provisioning status is visible on the Workspace page:
| Status | Meaning |
|---|---|
| Creating | Initializing workspace |
| Provisioning | Setting up namespace, per-app limits, and monitoring |
| Active | Ready to use |
| Suspended | Workspace suspended (e.g., billing issue) |
Switching workspaces
Use the workspace switcher in the sidebar to switch between workspaces. Each workspace has its own:
- Application list
- Billing and invoices
- Plan limits (app count and per-app shape)
- Team members
- GitHub integrations
- Custom domains
- Grafana organization
Workspace isolation
Workspaces are fully isolated at the infrastructure level:
- Namespace isolation — each workspace runs in its own Kubernetes namespace
- Network isolation — applications in different workspaces cannot communicate directly
- Resource isolation — per-app CPU and memory ceilings are enforced independently per workspace; applications in one workspace cannot consume resources from another
- Data isolation — persistent volumes, secrets, and environment variables are scoped to the workspace
- Monitoring isolation — Grafana dashboards only show data from your workspace