Workspaces
Workspaces, teams, and tenancy
How to use this capability
Ways to interact with this capability — pick a path to jump to the relevant section below.
SDK
Call actions from Node or React apps using the Ossy SDK — typed payloads and workspace context built in.
View section ↓
MCP
Connect Cursor to http://localhost:3006/mcp when MCP tools are available for workspaces.
View section ↓
HTTP
Call actions over HTTP with Bearer token authentication — create a token in Profile for scripts and automation.
View section ↓
UI widgets
Embed dashboard widgets or compose UI from packaged components in pages and apps.
View section ↓
Background tasks
Event-driven and scheduled handlers run in the background — triggered by the platform, not invoked like actions.
View section ↓
Aggregates
Domain entities and bounded-context models exposed by this capability for reads and composition.
View section ↓
Widgets
Compact widgets for your workspace dashboard — UI components you can also embed in pages or compose in apps.
Actions
Invokable intents — call directly via SDK, POST /actions, or MCP tools. This is the agent-facing surface, not background jobs.
Accept Invitation
@ossy/workspaces/actions/accept-invitation
Invoke @ossy/workspaces/actions/accept-invitation
MCP: ossy_workspaces_accept_invitation
sdk.invoke('@ossy/workspaces/actions/accept-invitation', { … })POST /actions
{ "action": "@ossy/workspaces/actions/accept-invitation", "payload": { … } }Background tasks
Background and scheduled handlers — triggered by events or cron, not called via SDK, POST /actions, or MCP. Ids use the tasks/ path (distinct from actions/).
Accept Invitation
@ossy/workspaces/tasks/accept-invitation
Create
@ossy/workspaces/tasks/create
Create Api Token
@ossy/workspaces/tasks/create-api-token
Disable Service
@ossy/workspaces/tasks/disable-service
Enable Service
@ossy/workspaces/tasks/enable-service
Get
@ossy/workspaces/tasks/get
Get Api Tokens
@ossy/workspaces/tasks/get-api-tokens
Get Invitations
@ossy/workspaces/tasks/get-invitations
Get Schemas
@ossy/workspaces/tasks/get-schemas
Get Users
@ossy/workspaces/tasks/get-users
Import Schemas
@ossy/workspaces/tasks/import-schemas
Invite User
@ossy/workspaces/tasks/invite-user
List
@ossy/workspaces/tasks/list
Remove Member
@ossy/workspaces/tasks/remove-member
Set Llm Monthly Token Limit
@ossy/workspaces/tasks/set-llm-monthly-token-limit
Sync Workspace Membership
Event-driven — syncs membership when workspace users change.
@ossy/workspaces/tasks/sync-workspace-membership
Aggregates
Domain aggregates and bounded-context entities.
Workspace
Workspace
User Workspaces
workspaces/data/user-workspaces
Resource types
Structured entities and templates registered for resources.
Invite User
@ossy/workspaces/schema/invite-user
Workspace
@ossy/workspaces/schema/workspace
Email templates
Transactional messages sent by this capability.
Invitation
@ossy/workspaces/emails/invitation