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#

Parameter	In	Type	Required	Description
X-Version	header	string	true	Version of the API (2026-01-01)
spreadsheetId	path	string	true	The unique identifier of the spreadsheet
sheetId	path	string	true	The unique identifier of the sheet
$deletevalues	query	boolean	false	Indicates whether values should be deleted along with the dataset

Code Samples#

curl

curl -X DELETE https://api.app.wdesk.com/spreadsheets/{spreadsheetId}/sheets/{sheetId}/dataset \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}' \
    -H 'X-Version: 2026-01-01'

httpie

http DELETE https://api.app.wdesk.com/spreadsheets/{spreadsheetId}/sheets/{sheetId}/dataset \
    X-Version:2026-01-01 \
    Accept:application/json \
    Authorization:"Bearer {access-token}"

wget

wget --method=DELETE "https://api.app.wdesk.com/spreadsheets/{spreadsheetId}/sheets/{sheetId}/dataset" \
    --output-document -  \ 
    --header 'Accept: application/json' \ 
    --header 'Authorization: Bearer {access-token}' \
    --header 'X-Version: 2026-01-01'

python

import requests

headers = {
  'X-Version': '2026-01-01',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

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

print(r.headers['Location'])

Returns#

202 - Accepted#

Response body for asynchronous operations. Contains an operationLocation field that specifies the URL to poll for the operation result. This URL can also be found in the Location header on the response.

Header	Description
Location	The location to poll for the operation result.
Retry-After	The number of seconds to wait before polling for a result and between polling attempts.