Initiate edit to table links

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#

Sends a TableLinksBatchEdit to perform on the links in a table.

The optional revision property can be used to identify a stable cell location in the table. The latest revision is used if not specified.

If the edit creates any new resources, such as destination links, the resourceUrl field will be populated with a link to the Table Links Edit Results endpoint to retrieve the IDs of the new resources.

POST /prototype/platform/content/tables/{tableId}/links/edit

Required OAuth Scopes

file:write

Parameters#

Parameter	In	Type	Required	Description
X-Version	header	string	false	Version of the API (2022-01-01)
tableId	path	string	true	The unique identifier for the table
body	body	TableLinksBatchEdit	true	The table link edits to apply

Body parameter example#

{
  "data": [
    {
      "insertCellDestinationLink": {
        "insertAt": {
          "column": 2,
          "row": 41
        },
        "sourceAnchor": "WA7i5vbm7lNaEn6XT9AtcW5vb22BJjMrqxmru"
      },
      "type": "insertCellDestinationLink"
    }
  ],
  "lockedCellEditMode": "strict",
  "revision": "24601abc"
}

Code Samples#

curl

curl -X POST https://api.app.wdesk.com/prototype/platform/content/tables/{tableId}/links/edit \
    -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/content/tables/{tableId}/links/edit \
    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/content/tables/{tableId}/links/edit" \
    --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/content/tables/{tableId}/links/edit', headers = headers)

print(r.headers['Location'])