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

Authorization

apiKey
X-API-Key<token>

Your SteelEngine API key (personal or workspace). Generate one from the SteelEngine dashboard under Settings > API Keys.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/tables" \  -H "Content-Type: application/json" \  -d '{    "workspaceId": "wsp_abc123",    "name": "contacts",    "description": "Customer contacts",    "schema": {      "columns": [        {          "name": "email",          "type": "string",          "required": true,          "unique": true        },        {          "name": "name",          "type": "string",          "required": true        },        {          "name": "age",          "type": "number"        }      ]    }  }'
{  "success": true,  "data": {    "table": {      "id": "tbl_abc123",      "name": "contacts",      "description": "Customer contacts",      "schema": {        "columns": [          {            "name": "email",            "type": "string",            "required": true,            "unique": true          }        ]      },      "rowCount": 0,      "maxRows": 10000,      "createdAt": "2026-01-15T10:30:00Z",      "updatedAt": "2026-01-15T10:30:00Z"    },    "message": "Table created successfully"  }}