Create Workbook

curl --request POST \
  --url https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "",
  "tableType": "DYNAMIC",
  "title": "Workbook 1"
}
'

import requests

url = "https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables"

payload = {
    "description": "",
    "tableType": "DYNAMIC",
    "title": "Workbook 1"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({description: '', tableType: 'DYNAMIC', title: 'Workbook 1'})
};

fetch('https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => '',
    'tableType' => 'DYNAMIC',
    'title' => 'Workbook 1'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables"

	payload := strings.NewReader("{\n  \"description\": \"\",\n  \"tableType\": \"DYNAMIC\",\n  \"title\": \"Workbook 1\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"\",\n  \"tableType\": \"DYNAMIC\",\n  \"title\": \"Workbook 1\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"\",\n  \"tableType\": \"DYNAMIC\",\n  \"title\": \"Workbook 1\"\n}"

response = http.request(request)
puts response.read_body

WorkBook

Create Workbook

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:

Validate workspace access
Create workbook metadata
Initialize table configuration
Persist configuration
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

POST

noCo

api

workspaces

{workspaceId}

tables

Create Workbook

curl --request POST \
  --url https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "",
  "tableType": "DYNAMIC",
  "title": "Workbook 1"
}
'

import requests

url = "https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables"

payload = {
    "description": "",
    "tableType": "DYNAMIC",
    "title": "Workbook 1"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({description: '', tableType: 'DYNAMIC', title: 'Workbook 1'})
};

fetch('https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => '',
    'tableType' => 'DYNAMIC',
    'title' => 'Workbook 1'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables"

	payload := strings.NewReader("{\n  \"description\": \"\",\n  \"tableType\": \"DYNAMIC\",\n  \"title\": \"Workbook 1\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"\",\n  \"tableType\": \"DYNAMIC\",\n  \"title\": \"Workbook 1\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/tables")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"\",\n  \"tableType\": \"DYNAMIC\",\n  \"title\": \"Workbook 1\"\n}"

response = http.request(request)
puts response.read_body

Authorizations

Authorization

string

header

required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

workspaceId

string

required

Body

application/json

title

string

required

description

string

Response

200

Create Workbook

Get All Workbooks in workspace Get Workbook Schema

Getting Started

Workspaces

Sign up

AI Extraction

WorkBook

Links & Joins

Knowledge Graph

Enterprise Search

Create Workbook

1️⃣ Overview

2️⃣ Endpoint

3️⃣ Path Parameters

4️⃣ Authentication

5️⃣ Required Permissions

6️⃣ Request Headers

7️⃣ Request Body Schema

8️⃣ Field Descriptions

9️⃣ Example Request

🔄 Behavior

🔹 Table Type Behavior

✅ Successful Response Example

📌 Behavior Summary

Authorizations

Path Parameters

Body

Response