Skip to main content
A workspace is where decks, files, members, invitations and the audit log live. Everything you do in Slideless happens in exactly one workspace at a time, and nothing crosses from one workspace to another: a deck, a file, a member list or an audit row belongs to one workspace and is invisible from every other, even on the same instance and even to that instance’s other owners.

One person, several workspaces

An account is a person, not a seat in one workspace. The same sign-in can belong to several workspaces, with a different role in each: owner of your own, plain member of a client’s. The workspace switcher in the sidebar lists them. For the API, the CLI and agents, the workspace is a per-request choice: send X-Workspace-Id: <workspace id>, or leave it out to land in your default workspace. GET /api/v1/me lists the workspaces you can name and the one the request resolved to. Your default workspace is yours to choose. On a self-hosted instance, open the workspace switcher, rest on a workspace and pick Make default, or run slideless workspace default <id or name>; until you choose, the default is the workspace you joined first. On Slideless Cloud the default is a setting of your Antasphere account, chosen at account.antasphere.com. The dashboard opens the workspace you last worked in on that browser, and the default when it has none to remember. Being a member of a workspace is not a grant on its decks. Inside a workspace, a deck is readable by its owner, by the workspace’s admins and owners, and by the collaborators invited on it (Decks).

A workspace holds projects

A workspace can be split into projects (Projects): a name, a description, members taken from the workspace’s own roster, and the decks linked to the project. A project is the way to give a few colleagues one client’s decks without opening the rest. Any member creates one and becomes its manager; the workspace’s admins and owners act as managers on every project. On cloud the workspace roster is managed at Antasphere, but its projects stay in Slideless.

A workspace holds teams

A team is a named group of the workspace’s people, which a project can take as a member (Projects). Every member of the workspace reads the teams; an owner or an admin creates, renames and deletes them and seats people, from the People page or from the CLI (slideless teams, CLI reference). Deleting a team leaves its people in the workspace. On Slideless Cloud the teams of an organization are the ones defined at account.antasphere.com: they are read here, marked as Antasphere’s, and managed there; putting one on a project is still done in Slideless.

Creating another workspace

The first workspace of a self-hosted instance is created at setup. After that, a signed-in person creates another one from the workspace switcher, and becomes its owner. It starts empty: no deck, no member and no audit row is carried over, and the workspace you were in is not told. In the dashboard, open the workspace menu at the top of the sidebar and choose New workspace. Give it a name; once it is created the dashboard switches to it, so you land in the new workspace. The menu is there as soon as you may create a workspace, even if you belong to only one. When creation is closed and you belong to one workspace, the sidebar shows the instance name and no menu. Someone who is signed in but belongs to no workspace yet is offered the same dialog on the page that says so. Files you download from the dashboard (deck attachments, files sent through a form, exports) always come from the workspace you are in.
The name is 1 to 120 characters; surrounding spaces are trimmed. Pass the returned id as X-Workspace-Id to work in the new workspace. The call accepts an Idempotency-Key header, so a retried request never creates two. Who can create one:
  • A browser session only. API keys, OAuth tokens and MCP agents are refused: creating a workspace is a person’s decision, never a credential’s.
  • Not a guest. Someone whose only access is a per-deck collaborator invitation cannot (403 guest_forbidden). A member of any workspace can, whatever their role there.
  • Within the operator’s limit. On a self-hosted instance one person can own up to MAX_WORKSPACES_PER_USER workspaces (10 by default); past it the call answers 403 workspace_limit_reached. With the variable at 0, creation is closed for everyone (403 workspace_creation_disabled). See Deployment profiles.
GET /api/v1/me carries canCreateWorkspace, true when the call would be accepted right now. A client shows or hides its “new workspace” entry from that one flag. On cloud the flag stays true for someone who signed in before workspace creation existed: their first attempt answers 401 hub_reauth_required, they sign in again, and the retry goes through.

On Slideless cloud

On cloud a workspace is an Antasphere organization (Antasphere account). Creating a workspace from Slideless creates the organization at Antasphere, in your name, with you as its owner, and it appears in Slideless at once. The number of organizations one person can own is Antasphere’s limit. Members of that organization are then invited and managed at account.antasphere.com, like every other organization.

Leaving and deleting

A workspace must keep at least one active owner, so the last owner cannot leave, be demoted or delete their account while they are the only one. An account that belongs to several workspaces cannot be deleted by an admin of one of them: that admin removes the person from the workspace instead, and the account stays with its other workspaces. An owner or an admin has three ways to take someone out, from the row’s menu on the Members page: A removed person is shown as inactive on the Members page, with the role Member whatever they held. Every invitation that was open for them, or that they had sent, is revoked with the removal. Only the workspace brings them back, by an act made after it: Reactivate, a new invitation, or an invitation on a deck. They come back as a member with no project, no team and no deck shared with them, and are added back where they are needed. The decks they own stay in the workspace, readable by its admins and owners. Their API keys are theirs and are not revoked: a key reaches the workspace again once the person is a member again, so revoke the keys too when that matters. The share links they minted keep serving their decks, which stay in the workspace: revoke a link from the deck’s page when it should stop. A demo link they minted, or one made for them, stops with the removal (Demo links). On Slideless Cloud the members of an organization are removed at account.antasphere.com, with the same result here, and they come back the same way: a person who left an organization is added to it again on the account site, and an invitation on a deck does not bring them back.