Workspaces — User Guide Overview
A workspace is your team's shared space for organizing projects, members, and activity. This guide walks you through everything you can do as a workspace user.
What you can do
- Create and manage workspaces for your team or for yourself
- Organize work into projects inside each workspace, with status, archive, and tag filters
- Invite teammates by email, assign roles, and manage pending invitations
- Track activity across the workspace
- Adjust workspace settings (name, contact email, domain, website, tags) to fit how your team works
- Arrange a personal dashboard of widgets that summarize your workspaces, projects, members, activity, and more
Feature previews
Some pages are gated behind feature flags (workspaces.projects, workspaces.members, workspaces.activity, workspaces.settings). If a link is not visible in your navigation or you see a "Feature Not Available" message, enable the relevant flag under Feature Previews in your account.
Where to find things
| Task | Where |
|---|---|
| See all your workspaces | /workspaces and /workspaces/list |
| Create a new workspace | /workspaces/new |
| Open a workspace | /workspaces/:workspaceId |
| Manage workspace settings | /workspaces/:workspaceId/settings |
| Browse projects (across all your workspaces) | /workspaces/projects |
| Browse projects in a single workspace | /workspaces/:workspaceId/projects |
| Open a project | /workspaces/:workspaceId/projects/:projectId |
| Manage members | /workspaces/members and /workspaces/:workspaceId/members |
| View activity | /workspaces/activity and /workspaces/:workspaceId/activity |
| Accept an invitation | /workspaces/invite/:invitationId |
| Workspaces dashboard (widgets) | Mounted as a dashboard host route by the shell app |
Any unknown sub-route under /workspaces/... redirects to /workspaces/list.
Detailed guides
- Creating and managing workspaces
- Working with projects
- Inviting and managing members
- Viewing activity
- Workspace settings
- Dashboard
- Project detail page
Permissions at a glance
Most actions are gated by RBAC permissions in resource:action form. The most common ones you will see referenced in this guide:
| Permission | Lets you |
|---|---|
workspace:read | View a workspace |
workspace:create | Create a workspace in an org you belong to |
workspace:update | Edit workspace settings |
workspace:archive | Archive / reactivate a workspace |
workspace:delete | Delete a workspace |
workspace-member:list / read | See members |
workspace-member:create | Invite members / resend invitations |
workspace-member:update | Change member roles |
workspace-member:delete | Remove a member |
project:list / read | See projects |
project:create / update / archive / delete | Manage projects |
activity:read | See the activity feed |
If a button is disabled with a tooltip explaining the missing permission, or if a page shows an "Access Denied" card, this is what is being checked. Ask a workspace owner or an admin to grant you the relevant role.
Need help?
If something is not working as expected, contact your workspace owner or open a support ticket.