Partially update a table’s properties#

Description#

Partially updates a table’s properties given its ID.

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.

Options#

Path	PATCH Operations Supported	Value Type
`/name`	`replace`	`string`
`/resizeRowsToFit`	`replace`	`boolean`, `null`
`/alternateRowFills`	`replace`	Array of `AlternateRowFill`
`/printArea`	`replace`	Array of `CellRange`, `null`
`/lock`	`replace`	`TableLockType`, `null`

PATCH /content/tables/{tableId}/properties

Required OAuth Scopes

file:write

Parameters#

Parameter	In	Type	Required	Description
X-Version	header	string	true	Version of the API (2026-01-01)
tableId	path	string	true	The unique identifier for the table
body	body	JSONPatchDocument	true	Patch document representing the changes to be made to the table’s properties

Body parameter example#

[
  {
    "op": "replace",
    "path": "/resizeRowsToFit",
    "value": true
  }
]

Code Samples#

curl

curl -X PATCH https://api.app.wdesk.com/content/tables/{tableId}/properties \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}' \
    -H 'X-Version: 2026-01-01'

httpie

http PATCH https://api.app.wdesk.com/content/tables/{tableId}/properties \
    X-Version:2026-01-01 \
    Content-Type:application/json \
    Accept:application/json \
    Authorization:"Bearer {access-token}"

wget

wget --method=PATCH "https://api.app.wdesk.com/content/tables/{tableId}/properties" \
    --output-document -  \ 
    --header 'Content-Type: application/json' \ 
    --header 'Accept: application/json' \ 
    --header 'Authorization: Bearer {access-token}' \
    --header 'X-Version: 2026-01-01'

python

import requests

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

r = requests.patch('https://api.app.wdesk.com/content/tables/{tableId}/properties', 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.