Reapply filters to the spreadsheet

Deprecated

This endpoint is deprecated and may be removed in a future release.

This endpoint was deprecated on 2026-02-12.

It is scheduled for sunset on 2027-01-31.

Description#

Performs a PrototypeSpreadsheetFiltersReapplication on the specified spreadsheet. This endpoint is used to refresh the spreadsheet’s filters based on the latest state or configuration changes. The filters are reapplied in the context of the spreadsheet’s current data state.

This is a long-running operation. Responses include a Location header, which indicates where to poll for results. For more details on long-running job polling, see Operations endpoint.

POST /prototype/platform/spreadsheets/{spreadsheetId}/filters/reapplication

Required OAuth Scopes

file:write

Parameters#

Parameter	In	Type	Required	Description
X-Version	header	string	false	Version of the API (2022-01-01)
spreadsheetId	path	string	true	The unique identifier of the spreadsheet
body	body	PrototypeSpreadsheetFiltersReapplication	true	The filter reapplication request to apply

Body parameter example#

{
  "ignoreNonEditableFilters": true
}

Code Samples#

curl

curl -X POST https://api.app.wdesk.com/prototype/platform/spreadsheets/{spreadsheetId}/filters/reapplication \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}' \
    -H 'X-Version: 2022-01-01'

httpie

http POST https://api.app.wdesk.com/prototype/platform/spreadsheets/{spreadsheetId}/filters/reapplication \
    X-Version:2022-01-01 \
    Content-Type:application/json \
    Accept:application/json \
    Authorization:"Bearer {access-token}"

wget

wget --method=POST "https://api.app.wdesk.com/prototype/platform/spreadsheets/{spreadsheetId}/filters/reapplication" \
    --output-document -  \ 
    --header 'Content-Type: application/json' \ 
    --header 'Accept: application/json' \ 
    --header 'Authorization: Bearer {access-token}' \
    --header 'X-Version: 2022-01-01'

python

import requests

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

r = requests.post('https://api.app.wdesk.com/prototype/platform/spreadsheets/{spreadsheetId}/filters/reapplication', headers = headers)

print(r.headers['Location'])