post

Overview
This endpoint is used for creating new tables on a dataset. Tables can only be created on unreleased versions — if the dataset has previously been released, make sure you are referencing the next version of the dataset in the dataset reference.
HTTP Request
POST /api/v1/datasets/:datasetReference/tables
Path parameters
Parameter
​
datasetReference
A qualified reference to the dataset. See referencing resources for more information.
This endpoint extends the general API structure​
Request body
Provide a JSON object with information about the table.
Property name
Type
Description
name
string
Required. The name of the table. Must be unique (non-word characters ignored) within the version of the dataset.
uploadMergeStrategy
string
Optional. How to handle subsequent uploads after the first version. Defaults to "append". Must be one of:
append - Uploads in future versions will append to the previous version of the table.
replace - Uploads in future versions will replace all data from the previous version of the table.
The upload merge strategy can be changed at a later point via table.patch​
isFileIndex
boolean
Optional. Default false.

Whether or not the table represents a collection of non-tabular files, with each row representing a file. Index tables are also referred to as "Folders" in some parts of the user interface.

If a table is created with isFileIndex=true, you will be able to add files via the Files.post method. Otherwise, for non-fileIndex tables, you can upload tabular data via Uploads.post.
description
string
Optional. A description of the table, limited to 5000 characters.
Authorization
Edit access to the dataset is required. Your access token must have the following scope:
data.edit
​Learn more about authorization.​
Response body
Returns the JSON-encoded "get" representation of a table resource.

Last modified 4mo ago

Property name	Type	Description
name	string	Required. The name of the table. Must be unique (non-word characters ignored) within the version of the dataset.
uploadMergeStrategy	string	Optional. How to handle subsequent uploads after the first version. Defaults to "append". Must be one of: append - Uploads in future versions will append to the previous version of the table. replace - Uploads in future versions will replace all data from the previous version of the table. The upload merge strategy can be changed at a later point via table.patch
isFileIndex	boolean	Optional. Default false. Whether or not the table represents a collection of non-tabular files, with each row representing a file. Index tables are also referred to as "Folders" in some parts of the user interface. If a table is created with `isFileIndex=true`, you will be able to add files via the Files.post method. Otherwise, for non-fileIndex tables, you can upload tabular data via Uploads.post.
description	string	Optional. A description of the table, limited to 5000 characters.

Parameter
datasetReference	A qualified reference to the dataset. See referencing resources for more information.