API Reference

Delete a single dataset

Description

Deletes the dataset for the specified sheet.

When you delete a dataset, you can select whether to leave its associated values in place. To delete its values, pass true for query parameter $deletevalues (default is false).

DELETE /spreadsheets/{spreadsheetId}/sheets/{sheetId}/dataset

🚧

Required OAuth Scopes:

file:write

Parameters

ParameterInTypeRequiredDescription
spreadsheetIdpathstringtrueThe unique identifier of the spreadsheet
sheetIdpathstringtrueThe unique identifier of the sheet
$deletevaluesquerybooleanfalseIndicates whether values should be deleted along with the dataset

Code Samples

curl -X DELETE https://api.app.wdesk.com/platform/v1/spreadsheets/{spreadsheetId}/sheets/{sheetId}/dataset  \ 
-H 'Authorization: Bearer {access-token}'
http DELETE https://api.app.wdesk.com/platform/v1/spreadsheets/{spreadsheetId}/sheets/{sheetId}/dataset  \ 
Authorization:"Bearer {access-token}"
wget --method=DELETE "https://api.app.wdesk.com/platform/v1/spreadsheets/{spreadsheetId}/sheets/{sheetId}/dataset" \
 --output-document -  \ 
 --header 'Authorization: Bearer {access-token}'
import requests
headers = {
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://api.app.wdesk.com/platform/v1/spreadsheets/{spreadsheetId}/sheets/{sheetId}/dataset', headers = headers)

print(r.headers['Location'])

Returns

202 - Accepted

HeaderDescription
LocationThe location to poll for the operation result.
Retry-AfterThe number of seconds to wait before polling for a result and between polling attempts.