Skip to main content
POST
Create a table

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

database
string
required

Target database.

Body

application/json

POST /v1/create_table/{database}.

table_name
string
required
indexes
null | object

Index declarations for create_table.

schema
object[] | null

JSON column descriptors. Exactly one of schema or schema_ipc is required. Cannot express nested types; use schema_ipc for those.

schema_ipc
string | null

The table's Arrow schema as a base64-encoded Arrow IPC stream carrying only the schema message. Exactly one of schema or schema_ipc is required. Carries any Arrow type the engine accepts, nested included.

Response

Table created.

Last modified on August 19, 2026