Links

post

Overview

This endpoint is used for adding new non-tabular files to an index table (also shown as a "folder" in the UI). Files can only be added to tables on an unreleased version of a dataset — 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/tables/:tableReference/files
This endpoint extends the general API structure

Path parameters

Parameter
tableReference
A qualified reference to the table. See referencing resources for more information.

Query parameters

Parameter
Text
name
The name of the file being uploaded.

Request body

The data content of the file should be provided in the request body.

Authorization

Edit access to the dataset is required. Your access token must have the following scope:
  • data.edit

Response body

If successful, returns with a 201 status code and the following response body:
{
"kind": "rawFile",
"id": str,
"uri": str,
"url": str,
"name": str,
"md5Hash": str,
"size": numeric
}