> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nearnode.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace Management

> Multi-tenant workspace isolation — separate environments, teams, and billing under one account.

A **Workspace** (organization) is the top-level container for all NearNode resources — nodes, batches, templates, analytics, and team members. Every resource belongs to exactly one workspace.

## Multi-Workspace Architecture

Users can belong to multiple workspaces. Each workspace has its own:

* Node inventory and routing rules
* Batches and templates
* Analytics data and retention
* API keys and webhook configurations
* Billing and plan tier
* Custom domains
* Team members and role assignments

```
┌─ User: james@vidiai.ch ─────────────────────┐
│                                              │
│  ┌─ Workspace: VidiAI ──────────────────┐    │
│  │  Role: Owner                         │    │
│  │  Nodes: 342  │  Batches: 12          │    │
│  │  Plan: Enterprise                    │    │
│  └──────────────────────────────────────┘    │
│                                              │
│  ┌─ Workspace: Client Project ──────────┐    │
│  │  Role: Admin                         │    │
│  │  Nodes: 89   │  Batches: 3           │    │
│  │  Plan: Pro                           │    │
│  └──────────────────────────────────────┘    │
│                                              │
└──────────────────────────────────────────────┘
```

<Info>
  **Ops Tip:** Switch between workspaces using the workspace selector in the top-left of the Dashboard sidebar.
</Info>

## Creating a Workspace

New workspaces start on the Developer (free) plan. The creating user is automatically assigned the **Owner** role.

```bash theme={null}
curl -X POST https://nearnode.io/api/v1/organizations \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "slug": "acme-corp"
  }'
```

## Workspace Settings

| Setting          | Description                                    | Who Can Change |
| ---------------- | ---------------------------------------------- | -------------- |
| Name             | Display name shown in the sidebar              | Owner          |
| Slug             | URL-safe identifier (immutable after creation) | —              |
| Logo             | Workspace avatar                               | Owner          |
| Plan             | Billing tier (Developer / Pro / Enterprise)    | Owner          |
| Default timezone | Used for time-based routing rules              | Owner, Admin   |

## Data Isolation

Workspace data is **fully isolated** at the database level via Row Level Security (RLS). There is no cross-workspace data access — even at the API level, a key scoped to Workspace A cannot read Workspace B's nodes.

<Warning>
  Deleting a workspace **permanently destroys** all associated nodes, batches, templates, analytics data, and API keys. This action cannot be undone.
</Warning>

## Inviting Team Members

<Steps>
  <Step title="Open Members">
    Navigate to **Settings → Members** in the workspace.
  </Step>

  <Step title="Send Invite">
    Enter the email address and select a [role](/enterprise/roles-permissions). The invitee receives an email with a join link.
  </Step>

  <Step title="Accept">
    The invitee clicks the link, creates an account (if needed), and is added to the workspace with the assigned role.
  </Step>
</Steps>

<Note>
  Pending invitations expire after **7 days**. The invite can be resent from the Members page.
</Note>

## Transferring Ownership

Only the current Owner can transfer ownership to another workspace member:

1. Navigate to **Settings → Members**
2. Click the target member's role badge
3. Select **Transfer Ownership**
4. Confirm with your password

The previous owner is demoted to Admin. A workspace always has exactly one Owner.

## Plan Limits

| Feature             | Developer   | Pro         | Enterprise |
| ------------------- | ----------- | ----------- | ---------- |
| Nodes               | 25          | 1,000       | Unlimited  |
| Batches             | 3           | Unlimited   | Unlimited  |
| Templates           | 1           | 10          | Unlimited  |
| Team members        | 2           | 10          | Unlimited  |
| Custom domains      | —           | 1           | Unlimited  |
| Analytics retention | 30 days     | 1 year      | Unlimited  |
| API rate limit      | 100 req/min | 500 req/min | Custom     |

<Tip>
  Need to evaluate Enterprise features? Contact **[sales@nearnode.io](mailto:sales@nearnode.io)** for a 14-day trial on any workspace.
</Tip>