Create dataset table
POST /dataset-tables
POST
/dataset-tables
Authorizations
Section titled “Authorizations ”Request Body
Section titled “Request Body ”object
datasetId
required
ID of the parent dataset
string
tableName
required
Human-readable table name (1-255 characters)
string
description
Optional description of the table’s purpose
string
fields
required
Array of column definitions (at least one required)
Array<object>
object
name
required
string
arrowType
required
string
nullable
boolean
metadata
object
key
additional properties
string
primaryKeyColumns
Column names to use as primary key for upsert operations
Array<string>
Responses
Section titled “ Responses ”Dataset table created successfully
object
tableId
required
Unique identifier for the table
string
datasetId
required
ID of the parent dataset
string
tableName
required
Human-readable name of the table
string
description
required
Optional description of the table’s purpose
string
createdAt
required
When the table was created
string format: date-time
updatedAt
required
When the table was last modified
string format: date-time
Bad Request - Validation error or invalid input
object
error
required
string
code
string
details
retryable
boolean
Unauthorized - Authentication required or invalid token
object
error
required
string
code
string
details
retryable
boolean
Forbidden - Insufficient permissions
object
error
required
string
code
string
details
retryable
boolean
Not Found - Resource does not exist
object
error
required
string
code
string
details
retryable
boolean
Conflict - Resource already exists or operation conflicts with current state
object
error
required
string
code
string
details
retryable
boolean
Internal Server Error - Unexpected server error
object
error
required
string
code
string
details
retryable
boolean