Datasets: Update from source files
Files added via the Add file from URL button on data.world, or the POST:/files api endpoint will have the source URL stored so they can be easily updated to the latest source version.
Update manually on data.world using the Fetch latest link on the file, or use this method to invoke automatically from where you're working. For example, via:
- Webhooks (e.g. Github Webhooks)
- Scripts (e.g. Google Sheets Custom Menu)
Methods
POST /datasets/{owner}/{id}/sync
For convenience (and sometimes necessity), this endpoint can also be invoked via HTTP GET:
GET /datasets/{owner}/{id}/sync
Parameters
Parameters:
| Parameter | Description | Parameter Type | Data Type |
|---|---|---|---|
| owner | Dataset owner username. Included in data.world dataset URL path, after domain. For example, jonloyens in https://data.world/jonloyens/an-intro-to-dataworld-dataset |
path | string |
| id | Dataset id. Included in data.world dataset URL, after owner's username. For example, an-intro-to-dataworld-dataset in https://data.world/jonloyens/an-intro-to-dataworld-dataset |
path | string |
Response
JSON schema
{
"message": "string"
}
Errors
| HTTP Status Code | Reason | Solution |
|---|---|---|
| 400 | Bad request. | Check syntax and URIs. |
| 401 | Unauthorized | Verify credentials / API key |
| 403 | Forbidden | |
| 404 | Not found. | |
| 422 | Bad request. | Check syntax and URIs. |
| 500 | Server error. |
Request URL:
https://api.data.world/v0/datasets/jonloyens/an-intro-to-dataworld-dataset/sync
cURL:
curl https://api.data.world/v0/datasets/jonloyens/an-intro-to-dataworld-dataset/sync?authentication=Bearer+<API TOKEN>
Response Body:
{
"message": "Sync started."
}