post

/datasets/{owner}/{id}/files

authorization: oauth2

Add files from URLs to a dataset. This method allows files published on the web to be added to a data.world dataset via their URL. This method can also be used to retrieve data via web APIs, with advanced options for http method, request payload and authentication.

The source URL will be stored so you can easily update your file anytime it changes via the fetch latest link on the data.world dataset page or by triggering the GET:/sync endpoint.

2 Path Parameters

Request Body

1 Example
Schema
object
files
array[object]

Updated set of files. When updating a set of files, file uploads are not supported. However, this property can be used to add files via URL or update metadata related to existing files.

description
string

File description.

2 validations
labels
array[string]

File labels.

2 validations
name
string

File name. Should include type extension always when possible. Must not include slashes.

3 validations + required
source
object

This model is utilized where source URLs can be specified for files to be added or updated.

Responses

OK The request has succeeded.

1 Example
Schema
object
message
string

Send a Test Request

Path Params
2 path params not set
owner
id
$$.env
1 variable not set
oauth_access_token