v13

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-015232292.9 KB

Tables

Create Table

Create a new table in a workspace. Define the table schema with typed columns, optional constraints (required, unique), and a name.

post/api/v1/tables

Request body

workspaceIdstring required

The workspace to create the table in.

namestring required

Table name. Must start with a letter or underscore, alphanumeric and underscores only.

descriptionstring

Optional description of the table.

Example request

{
  "schema": {
    "columns": [
      {
        "name": "email"
      }
    ]
  }
}

Response

Table created successfully.

successboolean

Indicates whether the request was successful.

Example response

{
  "data": {
    "table": {
      "id": "tbl_92e4c6a8b0d24f1e8a3c5d7b9f0e2a14",
      "name": "contacts",
      "description": "Customer contact records",
      "schema": {
        "columns": [
          {
            "name": "email"
          }
        ]
      }
    }
  }
}