files

Upload one file at a time to a dataset.

This endpoint expects requests of type application/octet-stream.

For example, assuming that you want to upload a local file named file1.csv to a hypothetical dataset https://data.world/awesome-user/awesome-dataset and choose its name on data.world to be better-name.csv, this is what the cURL command would look like.

curl \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -X PUT -H "Content-Type: application/octet-stream" \
  --data-binary @file1.csv \
  https://api.data.world/v0/uploads/awesome-user/awesome-dataset/files/better-name.csv

This method of upload is typically not supported by Swagger clients. Other HTTP clients can be used to supply the contents of the file directly in the body of the request.

put/uploads/{owner}/{id}/files/{file}

Request

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

Path parameters

ownerstring required
idstring required
filestring required

Filename

Query parameters

expandArchiveboolean

Request body */*

string binary required

Response

default response

messagestring

Changes