post

/datasets/{owner}

authorization: oauth2

Create a new dataset.

1 Path Parameter

Request Body

1 Example
Schema
object
description
string

Short dataset description.

maxLength: 120
minLength: 0
files
array[object]

Initial set of files. At dataset creation time, file uploads are not supported. However, this property can be used to add files via URL.

uniqueItems: false
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 only to be added.

required
license
string

Dataset license. Find additional info for allowed values here.

Allowed Values: Public Domain, PDDL, CC-0, CC-BY, CDLA-Permissive-1.0, ODC-BY, CC-BY-SA, CDLA-Sharing-1.0, ODC-ODbL, CC BY-NC, CC BY-ND, CC BY-NC-ND, CC BY-NC-SA, Other
summary
string

Long-form dataset summary (Markdown supported).

maxLength: 25000
minLength: 0
tags
array[string]

Dataset tags. Letters numbers and spaces only (max 25 characters).

uniqueItems: true
title
string

Dataset name.

required
maxLength: 60
minLength: 1
visibility
string

Dataset visibility. OPEN if the dataset can be seen by any member of data.world. PRIVATE if the dataset can be seen by its owner and authorized collaborators.

required
Allowed Values: OPEN, PRIVATE

Responses

OK The request has succeeded.

Schema
object
message
string
uri
string

URI of newly created dataset.

required

Send a Test Request

Path Params
1 path param not set
owner
$$.env
1 variable not set
oauth_access_token