Workspaces
Organization context, personal space, workspace selection, and members.
A workspace is the organization boundary for shared Epismo data. If no workspace is selected, data is stored in personal space.
Workspace names use the same constraints as workspace subdomains: 3 to 30 characters, lowercase letters a-z, numbers 0-9, and hyphens. Reserved names are rejected.
Personal space
Personal space belongs to the current user. Use it for private experiments, drafts, and individual workflows that should not be shared with a team.
Workspace context
The CLI resolves workspace context in this order:
EPISMO_TOKENembedded workspace.- Saved default from
epismo workspace use <workspace-id>. - Personal space fallback.
The API can accept workspaceId on supported endpoints. MCP derives workspace context from the bearer token.
Members
Workspace member roles are:
| Role | Use for |
|---|---|
owner |
Workspace ownership and administration |
admin |
Administrative operations |
member |
Standard workspace access |
Workspace membership determines which users can participate in workspace projects and appear in workspace user resources.
Workspace plan values are basic and pro. Workspace checkout returns a billing URL for completing or retrying payment.