Workbooks

Workbooks are lightweight containers for related programmable Tables. Every Table belongs to a Workbook, and a workspace always has an editable Untitled Workbook when none exists.

Workbook-first product

Put durable work in Tables; use descriptions, long-text fields, record detail, views, and activity for supporting context. Current REST paths, MCP tool names, and the project_id field retain the older Project noun for compatibility.

Create a Workbook

Create a named Workbook with the app or the current compatibility MCP tool. The public REST API lists Workbooks and creates Tables inside them, but it does not currently expose a REST create-Workbook operation.

{
  "tool": "hypertab_create_project",
  "arguments": { "title": "Customer research" }
}

List Workbooks

GET /v1/projects is the compatibility route that returns the current workspace's Workbooks. If the workspace has none, Hypertab creates and returns an editable Untitled Workbook.

{
  "tool": "hypertab_list_projects",
  "arguments": {}
}

Create a Table in a Workbook

Pass the selected Workbook's compatibility project_id to hypertab_create_table. Hypertab creates the Table and its Workbook ownership as one operation. REST clients can send the same Table body without project_id to POST /v1/projects/:projectId/tables.

{
	"tool": "hypertab_create_table",
  "arguments": {
	"project_id": "pg_project_id",
	"name": "customer_research",
	"columns": [{ "name": "customer", "type": "text" }]
  }
}

For MCP

Use hypertab_list_projects → hypertab_create_project when needed → hypertab_create_table with the Workbook's compatibility ID. These tool names retain Project for existing clients. Return the direct Table link when finished.

Authentication

Tables