Workspaces

Workspaces are the top-level organizational unit in Auva Notes. Think of them as project folders: each one contains its own set of notes, tags, and collaborators.

Auva Notes is in development. These API endpoints represent the planned design and may change before launch.

Create a Workspace

text

POST https://notes.auva.dev/api/workspaces
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "name": "Product Roadmap",
  "description": "Planning and feature specs for Q2 2025"
}

Response:

text

{
  "id": "ws_abc123",
  "name": "Product Roadmap",
  "description": "Planning and feature specs for Q2 2025",
  "noteCount": 0,
  "createdAt": "2024-03-15T10:30:00.000Z"
}

List Workspaces

text

GET https://notes.auva.dev/api/workspaces
Authorization: Bearer YOUR_ACCESS_TOKEN

Create a Note in a Workspace

text

POST https://notes.auva.dev/api/workspaces/{id}/notes
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "title": "Feature Spec: Dark Mode",
  "content": "## Overview\n\nImplement system-wide dark mode support...",
  "tags": ["feature", "design"],
  "pinned": false
}

Search Notes

text

GET https://notes.auva.dev/api/search?q=dark+mode
Authorization: Bearer YOUR_ACCESS_TOKEN

Search works across all workspaces by default. Add &workspace={id} to limit to a specific workspace.

Response:

text

{
  "results": [
    {
      "id": "note_001",
      "title": "Feature Spec: Dark Mode",
      "snippet": "Implement system-wide **dark mode** support with...",
      "workspaceId": "ws_abc123",
      "workspaceName": "Product Roadmap",
      "relevance": 0.94
    }
  ],
  "total": 1,
  "query": "dark mode"
}

Workspace Limits

Constraint	Free	Pro
Workspaces per account	5	Unlimited
Notes per workspace	100	Unlimited
Max note size	50 KB	500 KB
Version history	7 days	90 days
Collaborators per workspace	3	20