Skip to main content

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​

TaskWhere
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​

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:

PermissionLets you
workspace:readView a workspace
workspace:createCreate a workspace in an org you belong to
workspace:updateEdit workspace settings
workspace:archiveArchive / reactivate a workspace
workspace:deleteDelete a workspace
workspace-member:list / readSee members
workspace-member:createInvite members / resend invitations
workspace-member:updateChange member roles
workspace-member:deleteRemove a member
project:list / readSee projects
project:create / update / archive / deleteManage projects
activity:readSee 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.