Workspaces

Workspaces help you organize your work in sajn. Think of them as separate folders or projects within your organization — each with its own documents, contacts, and settings.

Why Use Workspaces?

Separate Projects

Keep different projects or clients completely separate

Team Access

Control which team members can access what

Stay Organized

Manage large volumes of documents without the clutter

What Belongs to a Workspace?

Each workspace has its own isolated set of data:

Resource	Description
Documents	All documents created or imported
Contacts	People and companies you send documents to
Templates	Reusable document templates
Tags	Labels for organizing documents
Files	Uploaded PDFs and other files
Webhooks	Event notifications
API Tokens	Credentials for API access
Members	People with access to the workspace
Roles	Permission sets that control what members can do

Data is completely isolated between workspaces. A document in one workspace cannot access contacts from another workspace.

Workspace Properties

Every workspace has:

Property	Description
Slug	Unique identifier (e.g., `sales-team`)
Name	Display name (e.g., “Sales Team”)
Color	Visual identifier in the dashboard
Icon	Optional icon for quick recognition

Common Use Cases

Multiple Clients

Agencies and consultants can create a workspace for each client to keep their documents and contacts separate.

Departments

Large organizations can have separate workspaces for HR, Legal, Sales, etc.

Projects

Create workspaces for major projects that need their own document workflows.

Workspace Limits by Plan

The number of workspaces you can create depends on your subscription:

Plan	Workspaces
BASIC / SOLO	1
TEAM	5
ENTERPRISE	Unlimited

Need more workspaces? Contact us at [email protected] to discuss your needs.

Working with Workspaces

In the Dashboard

Switch between workspaces using the workspace selector in the top navigation. Your current workspace determines which documents, contacts, and settings you see.

Via API

When using the API, your API token is scoped to a specific workspace. All API operations affect only that workspace’s data.

# Your API token determines which workspace you're working with
curl -H "Authorization: Bearer YOUR_WORKSPACE_TOKEN" \
  https://api.sajn.se/api/v1/documents

Managing Members and Roles

You can administer a workspace’s team programmatically:

Resource	Endpoints
Members	List, fetch, update a member’s role, and remove members — `GET/PATCH/DELETE /api/v1/members`
Invitations	List pending invites, resend, and revoke — `GET /api/v1/member-invites`, `POST /api/v1/member-invites/{id}/resend`
Roles	Create, fetch, update, and delete custom roles — `GET/POST/PATCH/DELETE /api/v1/workspace-roles`
Permissions	List every permission key assignable to a role — `GET /api/v1/workspace-permissions`

Member and role endpoints require the MANAGE_WORKSPACE_MEMBERS and MANAGE_WORKSPACE_ROLES permissions respectively.

Plan Limits and Usage

Check the organization’s plan quotas, current usage, and remaining allowances for the billing month — documents, BankID signatures, members, AI tokens, identity checks, and workspaces — with GET /api/v1/limits. Unlimited quotas are returned as null.

​Workspaces

​Why Use Workspaces?

Separate Projects

Team Access

Stay Organized

​What Belongs to a Workspace?

​Workspace Properties

​Common Use Cases

​Multiple Clients

​Departments

​Projects

​Workspace Limits by Plan

​Working with Workspaces

​In the Dashboard

​Via API

​Managing Members and Roles

​Plan Limits and Usage

​Next Steps

Documents

Contacts

Workspaces

Why Use Workspaces?

What Belongs to a Workspace?

Workspace Properties

Common Use Cases

Multiple Clients

Departments

Projects

Workspace Limits by Plan

Working with Workspaces

In the Dashboard

Via API

Managing Members and Roles

Plan Limits and Usage

Next Steps