Blocks
Canvas block CRUD, bulk positions, and arrange.
Blocks are canvas nodes created by agents or users. Project-scoped routes live under /api/v1/projects/:id/blocks.
Endpoints
| Method | Path | Description |
|---|---|---|
POST | /api/v1/blocks | Create a block (org context). |
PATCH | /api/v1/blocks/:id | Update title, data, position. Optional expectedUpdatedAt revision returns 409 when stale instead of overwriting; omitted keeps last-write-wins. |
DELETE | /api/v1/blocks/:id | Soft-delete. |
PATCH | /api/v1/projects/:id/blocks/positions | Bulk positions — atomic; all IDs must belong to the project. |
POST | /api/v1/blocks/arrange | AI layout; invalid layouts return 400 before billing. |
POST | /api/v1/blocks/:id/google-workspace/sync | Pull linked Google content. |
POST | /api/v1/blocks/:id/google-workspace/push | Push block content to Google. |
See Blocks for the four creation paths (data_block, show, MCP App, app_create).