Workspaces Management

Workspaces organize docs across teams and products — belong to many, with a different role in each.

Workspace vs. project

This is the question we hear most, so here’s the quick mental model:

So the hierarchy is simply Workspace → Projects → Sections. Keep one workspace with a project per API, or spin up separate workspaces per brand or team — whatever matches how your organization is structured.

“Project” and “documentation” mean the same thing. Across Theneo you’ll see both terms used for a single docs project — for example, “publish your documentation” and “publish your project” describe the exact same action.

Workspace basics

Your first workspace is created during sign-up as part of onboarding, and you’re assigned the Admin role in it.

You can also be invited to other workspaces by teammates or other organizations, and have different roles in each (for example, Admin in one and Editor in another). Your access always depends on the role you hold in that specific workspace.

Personal vs. Corporate

When creating a workspace, you choose a type:

• Personal — for individual or freelance use.
• Corporate — recommended for team collaboration.

Our recommendation: go Corporate

We strongly recommend a Corporate workspace, even when starting out. Corporate workspaces unlock team-oriented capabilities:

• Collaborating with team members in the same workspace
• Inviting members to workspaces and projects
• Working together within a project
• Sharing private projects with teammates
• Domain whitelisting and other company features

These are restricted in Personal workspaces.

Both Personal and Corporate workspaces are available on the Free tier. We only recommend Personal for specific individual-only use cases.

Switching Personal → Corporate (one-way)

You can upgrade a workspace from Personal → Corporate in the Admin configuration. Important: this change is permanent — there’s no step back, and you can’t switch Corporate → Personal.

Viewing your workspaces

From the dashboard, open the Workspaces page to see all workspaces you belong to, your role in each, and available actions (such as Leave).

Create an additional workspace

Create more workspaces anytime — useful for separating docs by team, product, client, or environment.

1. Open the Workspaces page.
2. Click + Create Workspace next to the page title.
3. Complete the form: Name (required), Slug (auto-generated, editable), and Type (Personal or Corporate).
4. Click Create.

The new workspace appears immediately, and you’re assigned the Admin role in it.

Leave a workspace

To tidy up workspaces you no longer need:

1. Open the Workspaces page.
2. Find the workspace you want to leave.
3. Click Leave on the right of its row.

The workspace disappears from your list immediately.

Set a default workspace

Choose one workspace as your default — the starting point for key workflows:

• New projects are created in your default workspace (unless you choose another during the Create Project flow).
• Branding loads your default workspace’s settings first.
• Developer Portal configuration loads your default workspace first.

Switch workspace context

Even though Branding and the Developer Portal load from your default workspace, you can switch anytime — open Branding (or Developer Portal configuration) and use the workspace dropdown to select another workspace. The page updates to show that workspace’s settings.

Roles and permissions

Your role is set per workspace, so you can be an Admin in one and an Editor in another. These are the workspace roles:

Workspace settings (Admin)

Admins manage the workspace from the Admin area, opened from the workspace dropdown. The Workspace Settings tab gathers the controls below, alongside User Management, External Customer Management, Audit Log, and Webhooks.

FAQ