Workspaces

Every org starts with one workspace. On Team tier and above, Owners can create additional workspaces - for example a private manager workspace alongside the shared team graph. All workspace management lives at admin.recordar.io under Organisation - Workspaces.

How many workspaces can I have?

Only workspace Owners can create, rename, or delete workspaces. Members and Editors can view the list and switch their active workspace.

Creating a workspace

1. Sign in at admin.recordar.io as an Owner.
2. Go to Organisation - Workspaces and click New workspace.
3. Give it a name and choose a visibility:
   • Standard - all workspace members can read every memory in it
   • Private - only members explicitly invited to this workspace can read its memories
4. Click Create. The new workspace appears in the list immediately.

After creation, invite members from the Team page and generate API keys from API Keys. Keys are workspace-scoped, so you need a fresh key (or personal key) for each workspace you want to connect agents to.

Workspace visibility

Private workspaces are useful for manager-only notes, HR-sensitive material, or any context that should not be visible to the whole team. Setting a workspace to private does not affect memories already in a standard workspace - it only controls access to the private workspace itself.

Switching your active workspace

Your active workspace determines which graph your agent reads and writes to. The JWT your agent receives always carries the workspace you last activated.

1. Open admin.recordar.io.
2. Click the workspace switcher in the sidebar (shows your current workspace name).
3. Select the workspace you want to make active.

The portal reloads scoped to the new workspace. Any agent session started after switching will use the new workspace automatically - existing open sessions are not affected until they reconnect.

Renaming a workspace

1. Go to Organisation - Workspaces.
2. Find the workspace and click the edit (pencil) icon.
3. Enter a new name and save.

Renaming does not change the workspace ID, so existing API keys and agent configs continue to work without any changes.

Deleting a workspace

Deleting a workspace permanently removes it and all memories inside it. This cannot be undone.

1. Go to Organisation - Workspaces.
2. Find the workspace and click Delete.
3. Confirm the deletion in the dialog.

You cannot delete the last workspace in an org. The delete button is only visible to Owners.

Membership

Each workspace has its own member list. An Owner can invite someone to multiple workspaces independently - a user added to the team's main workspace is not automatically a member of any additional workspaces.

To invite a member to a specific workspace:

1. Switch to that workspace using the workspace switcher.
2. Go to Organisation - Team and send an invite.

Membership limits

To prevent a single user from being added to an unbounded number of workspaces, invite acceptance is subject to a membership cap. In practice this limit is generous enough that normal use won't approach it - contact admin@recordar.io if an invite is unexpectedly rejected.

Using multiple workspaces with your agent

Each workspace requires its own API key. To run two workspaces in parallel, give each agent config a different key:

{
  "mcpServers": {
    "recordari-team": {
      "type": "http",
      "url": "https://api.recordar.io/mcp",
      "headers": { "Authorization": "Bearer TEAM_WORKSPACE_KEY" }
    },
    "recordari-personal": {
      "type": "http",
      "url": "https://api.recordar.io/mcp",
      "headers": { "Authorization": "Bearer PERSONAL_WORKSPACE_KEY" }
    }
  }
}

Point different projects at different server entries to keep the graphs separate. See Authentication for key types and Getting Started for the full setup walkthrough.