# 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](https://docs.redivis.com/api/referencing-resources).

## HTTP Request

```http
POST /api/v1/datasets/:datasetReference/tables
```

## Path parameters

<table><thead><tr><th width="302.5">Parameter</th><th></th></tr></thead><tbody><tr><td>datasetReference</td><td>A qualified reference to the dataset. See <a href="../../referencing-resources">referencing resources</a> for more information.</td></tr></tbody></table>

{% hint style="info" %}
This endpoint extends the [general API structure](https://docs.redivis.com/api/rest-api/general-structure)
{% endhint %}

## 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**  | <p><strong>Optional.</strong> How to handle subsequent uploads after the first version. Defaults to "append". Must be one of:</p><ul><li><strong>append</strong> - Uploads in future versions will append to the previous version of the table.</li><li><strong>replace</strong> - Uploads in future versions will replace all data from the previous version of the table.</li></ul><p>The upload merge strategy can be changed at a later point via <a href="patch">table.patch</a></p>                                                           |
| **isFileIndex**         | **boolean** | <p><strong>Optional.</strong> Default false.<br><br>Whether or not the table represents a collection of non-tabular files, with each row representing <a href="../files">a file</a>. Index tables are also referred to as "Folders" in some parts of the user interface.<br><br>If a table is created with <code>isFileIndex=true</code>, you will be able to add files via the <a href="../files/post">Files.post </a>method. Otherwise, for non-fileIndex tables, you can upload tabular data via <a href="../uploads/post">Uploads.post</a>.</p> |
| **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.](https://docs.redivis.com/api/rest-api/authorization)

## Response body

Returns the JSON-encoded "get" representation of a[ table resource](https://docs.redivis.com/api/resource-definitions/table).