Skip to main content
POST
/
data
/
tables
Create Custom Data Table
curl --request POST \
  --url https://api.prod.usesimple.ai/api/v1/data/tables \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "label": "<string>",
  "columns": [
    {
      "name": "<string>",
      "displayName": "<string>",
      "referenceTable": "<string>",
      "jsonSchema": {}
    }
  ],
  "searchIndexingEnabled": false
}
'
{
  "id": 123,
  "name": "<string>",
  "label": "<string>",
  "searchIndexingEnabled": true,
  "columns": [
    {
      "id": 123,
      "name": "<string>",
      "displayName": "<string>",
      "referenceTable": "<string>",
      "jsonSchema": {},
      "position": 123
    }
  ],
  "recordCount": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Table and column names are stable identifiers used by the record endpoints. Use lowercase letters, numbers, and underscores. For REFERENCE columns, include referenceTable. For OBJECT columns, include jsonSchema.

Authorizations

​
Authorization
string
header
required

Body

application/json
​
name
string
required

Stable table identifier used in record endpoint paths.

Pattern: ^[a-z]([a-z0-9]+(_[a-z0-9]+)*)?$
​
label
string
required

Human-readable table name shown in Simple AI.

​
columns
Custom Data Column Input · object[]
required
Minimum array length: 1
​
searchIndexingEnabled
boolean
default:false

Whether this table can be searched with the custom data search and facets endpoints.

Response

Custom Data Table Created

​
id
integer
required
​
name
string
required
​
label
string
required
​
searchIndexingEnabled
boolean
required
​
columns
Custom Data Column · object[]
required
​
recordCount
integer
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required