Workspace API

Workspace pages, blocks, templates, versions, and comments are available via the REST API.

Authentication

Use a valid API token with tenant context. All endpoints require auth:sanctum.

Endpoints

Templates

GET /api/v1/workspace/templates

Returns available page templates (from config and blueprint-compatible sources).

Response:

{
  "data": [
    {
      "key": "blank",
      "title": "Untitled",
      "blocks_count": 0
    },
    {
      "key": "meeting_notes",
      "title": "Meeting Notes",
      "blocks_count": 5
    }
  ]
}

Pages

GET /api/v1/workspace/pages

Query parameters:

• parent_id – Filter by parent (omit for root)
• flat – If 1, return flat list instead of tree
• search – Search by page title
• archived – If 1, include archived pages

POST /api/v1/workspace/pages

Create a page from a template.

Body:

{
  "template_key": "meeting_notes",
  "parent_id": 123
}

• template_key (required): blank, meeting_notes, project_brief, or custom
• parent_id (optional): Parent page/folder ID

GET /api/v1/workspace/pages/{block}

Get a page or folder with its blocks.

PATCH /api/v1/workspace/pages/{block}

Update a page. Body can include content, icon, cover, archived.

Versions

GET /api/v1/workspace/pages/{block}/versions

List version history for a page.

POST /api/v1/workspace/pages/{block}/versions/{versionId}

Restore a version. Replaces current page content.

Comments

GET /api/v1/workspace/pages/{block}/comments

List comments for a page.

POST /api/v1/workspace/pages/{block}/comments

Add a comment.

Body:

{
  "content": "Your comment text"
}

Table

POST /api/v1/workspace/table/move-row

Move a table row to a different group (board view).

Body:

{
  "block_id": 456,
  "row_index": 1,
  "new_group_value": "Done"
}

• block_id – Table block ID
• row_index – 0-based row index (0 = first data row)
• new_group_value – Target column/group name

Updated on: 13/03/2026