Powered by Stoplight
put

/datasets/{owner}/{id}

Create or replace a dataset with a given id. If a dataset exists with the same id, this call will reset such dataset and all the data contained in it.

Authorization

oauth2 - authorizationCode

Request Parameters

2 Path Parameters

Request Body

2 Examples
Schema
object
description
string

Short dataset description.

2 validations
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.

1 validation
license
string

Dataset license. Find additional info for allowed values here.

1 validation
summary
string

Long-form dataset summary (Markdown supported).

2 validations
tags
array[string]

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

1 validation
title
string

Dataset name.

2 validations + required
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. DISCOVERABLE if the dataset can be seen by any member of data.world, but only files marked sample or preview are visible

1 validation + required
properties
object

Custom metadata properties. See /toolkit/custom-metadata for more information.

Responses

OK The request has succeeded.

1 Example
Schema
object
message
string

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
Path Params
2 path params not set
owner
id
$$.env
1 variable not set
oauth_access_token