Managing Workspaces
Configure and manage your workspaces.
Changing Workspace Name
- Navigate to workspace settings
- Locate workspace name field
- Enter new name
- Save changes
Tip: Workspace ID Remains Unchanged
The workspace ID remains unchanged after renaming. All API integrations will continue working without any modifications.
Workspace Information
View workspace details:
- Workspace ID: Unique identifier for API access
- Workspace Name: Current name
- Creation Date: When created
- Member Count: Number of users
- Active Services: Services in use
Deleting Workspaces
Requirements:
- Only Owners can delete workspaces
- All services must be deleted first
- Deletion is permanent
Warning: All Services Must Be Deleted First
You must delete all Managed Observability, Managed Applications, and Managed Cluster Components before you can delete the workspace.
Deletion Steps
Delete all services first
- Managed Observability configurations
- Managed Applications
- Managed Cluster Components
Navigate to workspace settings
Click "Delete Workspace"
- Error shown if services remain
- Confirmation required
Confirm deletion
- Type workspace name to confirm
- Workspace deleted immediately
Danger: Workspace Deletion Is Permanent
Workspace deletion is permanent and cannot be undone. You must back up all data before deleting a workspace.
Workspace Switching
If you're in multiple workspaces:
- Access workspace selector in navigation
- Select target workspace
- Portal switches context
API Reference
Get Workspace Details
GET /v1/workspaces/{workspaceId}
Authorization: Bearer <access-token>Update Name
PATCH /v1/workspaces/{workspaceId}
Authorization: Bearer <access-token>
Content-Type: application/json
{
"name": "New Name"
}Delete Workspace
DELETE /v1/workspaces/{workspaceId}
Authorization: Bearer <access-token>Warning: API Deletion Is Permanent
Workspace deletion via API is permanent and cannot be undone. Ensure you are using the correct workspace ID before executing this operation.
Info: Full API Documentation Available
These are example requests. For complete API documentation including all parameters, response schemas, and authentication details, visit api.cloudpirates.io/docs.