Initiate edit to table links

Table Of Contents

Initiate edit to table links#

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 /content/tables/{tableId}/links/edit

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	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/content/tables/{tableId}/links/edit \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}' \
    -H 'X-Version: 2026-01-01'

httpie

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

wget

wget --method=POST "https://api.app.wdesk.com/content/tables/{tableId}/links/edit" \
    --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.post('https://api.app.wdesk.com/content/tables/{tableId}/links/edit', headers = headers)

print(r.headers['Location'])

Returns#

202 - Accepted#

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.

400 - Bad Request#

Error response that indicates that the service is not able to process the incoming request. The reason is provided in the error message.

401 - Unauthorized#

Error response that indicates that the service is not able to process the incoming request. The reason is provided in the error message.

403 - Forbidden#

Error response that indicates that the service is not able to process the incoming request. The reason is provided in the error message.

404 - Not Found#

Error response that indicates that the service is not able to process the incoming request. The reason is provided in the error message.

409 - Conflict#

Error response that indicates that the service is not able to process the incoming request. The reason is provided in the error message.

429 - Too Many Requests#

Error response that indicates that the service is not able to process the incoming request. The reason is provided in the error message.

500 - Internal Server Error#

Error response that indicates that the service is not able to process the incoming request. The reason is provided in the error message.

503 - Service Unavailable#

Error response that indicates that the service is not able to process the incoming request. The reason is provided in the error message.

Example Responses#

Bad Request

{
  "code": "400BadRequest",
  "message": "The request was unacceptable, often due to a missing or invalid parameter"
}

Unauthorized

{
  "code": "401Unauthorized",
  "message": "No valid API token provided"
}

Forbidden

{
  "code": "403Forbidden",
  "message": "The API token does not have permissions to perform the request"
}

Not Found

{
  "code": "404NotFound",
  "message": "The requested resource could not be found"
}

Conflict

{
  "code": "409Conflict",
  "message": "The request conflicts with another request"
}

Too Many Requests

{
  "code": "429TooManyRequests",
  "message": "Too many requests have been made against the API in too short a time"
}

Internal Server Error

{
  "code": "500InternalServerError",
  "message": "The server encountered an unexpected condition that prevented it from fulfilling the request"
}

Service Unavailable

{
  "code": "503ServiceUnavailable",
  "message": "The server cannot handle the request due to a temporary overload or scheduled maintenance"
}