Resources and Workspaces

A workspace is a tenant-local container. Resources are documents, tables, artifacts, folders, and files arranged in a tree.

Common flow

1. GET /api/v1/workspaces

2. GET /api/v1/workspaces/{workspace_id}/resources

3. Resolve a resource id from the tree.

4. Read or update through the resource endpoint.

Resource types

• document: rich collaborative text.

• table: structured rows and columns.

• artifact: JSX/HTML or other rendered source.

• folder: hierarchy only.

• file: uploaded binary content.

The resource tree is permission-aware. Do not assume that a workspace list implies access to every resource in the workspace.