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

1
POST /api/v1/datasets/:datasetReference/tables
Copied!

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 "replace". 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
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

Response body

Returns the JSON-encoded "get" representation of a table resource.
Last modified 1yr ago