datasets

Create / Replace a dataset

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.

put/datasets/{owner}/{id}

Request

  • Base URL
    https://api.data.world/v0
  • URL
    https://api.data.world/v0/datasets/{owner}/{id}
  • Auth
    HTTP bearer

Path parameters

ownerstring required
idstring required

Request body

assetStatusIristring
descriptionstring
desiredAutoSyncstring date-time

Desired time for the next auto-sync. Used as a recurring time-of-day anchor for scheduled syncs.

license'Public Domain, PDDL, CC-0, CC-BY, CDLA-Permissive-1.0, CC-BY-IGO, CC-BY 3.0, CC-BY 3.0 AU, CC-BY 3.0 IGO, CC-BY-SA, CC-BY-SA 3.0, CDLA-Sharing-1.0, CC BY-NC, CC BY-ND, CC BY-ND 3.0, CC-BY 3.0 NZ, CC-BY-NC 3.0, CC BY-NC-ND, CC-BY-NC-SA 3.0, CC-BY-SA 3.0 NZ, CC-BY-NC-SA 3.0 NZ, CC-BY-NC 3.0 NZ, CC-BY-NC-ND-NZ-3.0, CC BY-NC-SA, Italian-ODL, MIT License, OGL, OGL-Canada, OGL-Nova Scotia, OGL-UK, OSODL, ODC-BY, ODC-ODbL, Other'
propertiesobject

Create/update any property that is associated with a metadata presentation. Key is the IRI of the property. Value is the intended value of the property.

summarystring
tagsstring[]
titlestring required
visibility'OPEN, PRIVATE' required

Example request

{
  "desiredAutoSync": "2026-07-31T14:01:55.700Z"
}

Response

default response

messagestring

Changes

No recorded changes to this operation across all 2 revisions of this API.