1️⃣ Overview

Purpose:

Creates a new Workbook inside a specified workspace.

This endpoint creates:

• A new table (workbook container)

• Basic metadata (title and optional description)

• Table type configuration (e.g., DYNAMIC)

---

2️⃣ Endpoint

POST /noCo/api/v2/workspaces/{workspaceId}/tables

---

3️⃣ Path Parameters

Parameter	Type	Required	Description
workspaceId	UUID	✅ Yes	Identifier of the workspace where the workbook will be created

---

4️⃣ Authentication

Requires Bearer JWT Token

Authorization: Bearer <token>

---

5️⃣ Required Permissions

User must have:

• CREATOR or EDITOR permission

---

6️⃣ Request Headers

Header	Required
Authorization	✅ Yes
Content-Type: application/json	✅ Yes

---

7️⃣ Request Body Schema

{  "title": "string",  "description": "string",  "tableType": "DYNAMIC | STATIC"}

---

8️⃣ Field Descriptions

Field	Type	Required	Description
title	string	✅ Yes	Display name of the workbook
description	string	❌	Workbook description
tableType	enum	❌	Type of table (e.g., DYNAMIC, STATIC)

---

9️⃣ Example Request

curl -X POST \https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables \-H "Authorization: Bearer <token>" \-H "Content-Type: application/json" \-d &#x27;{  "title": "Workbook 1",  "description": "",  "tableType": "DYNAMIC"}&#x27;

---

🔄 Behavior

When this endpoint is called:

1. Validate workspace access

2. Create workbook metadata

3. Initialize table configuration

4. Persist configuration

5. Return created workbook object

---

🔹 Table Type Behavior

Type	Description
DYNAMIC	Supports computed fields, AI columns, formulas
STATIC	Manual data entry only

---

✅ Successful Response Example

{  "id": "generated-table-uuid",  "title": "Workbook 1",  "tableType": "DYNAMIC",  "createdAt": "2026-02-26T13:00:00Z"}

---

📌 Behavior Summary

This endpoint:

Creates a new Workbook (table) with basic metadata inside a workspace;

It supports:

• Workbook creation with minimal configuration

• Optional description

• Table type selection