Skip to main content

Workspace settings

Workspace settings sections, permissions, and the shared settings shell.

SectionWorkspace / Settings
PurposeWorkspace settings reference
UpdatedJul 6, 2026
AuthorTemplate Maintainers
Versionv1.2.0
Reading time2 min

Workspace settings

Workspace settings are split into dedicated section pages. This keeps each management task focused and lets the navigation show only sections the current member can use.

Settings sections

SectionRouteWhat it contains
Workspace/w/:organizationKey/settings/workspaceWorkspace name, slug, and allowed email domains.
Users/w/:organizationKey/settings/usersCurrent user summary, member list, direct member add, and role controls.
Invitations/w/:organizationKey/settings/invitationsInvitation table, statuses, links, and create-invitation modal.
Teams/w/:organizationKey/settings/teamsExplicit workspace teams and team membership management.
Roles/w/:organizationKey/settings/rolesPlaceholder for future role expansion.
API keys/w/:organizationKey/settings/api-keysWorkspace-owned API keys for /api/v1.

The settings root redirects to the first available section after access validation.

Permissions

Regular members can read safe settings context such as member lists and teams. Management controls appear only for members whose role permits the action.

The invitations and API key sections are conditional: users without the required permissions do not see management actions and may not see the section link at all.

Shared settings shell

Account settings and workspace settings use the same visual shell: contextual intro first, then section islands for forms, lists, and empty states. This keeps dense operational pages readable in light and dark themes.