Copy section

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 2029-01-31.

Description#

Asynchronously copies a section given details about the copy’s destination within the same or another document. Options are specified using a SectionCopy object.

Copies only the section’s content — not any labels, comments, tasks, or formatting from a style guide. Unless otherwise specified, the copy appears at the top level of its destination document, with an index of 0, and with the same name as the original section.

POST /platform/v1/documents/{documentId}/sections/{sectionId}/copy

Required OAuth Scopes

file:write

Parameters#

Parameter	In	Type	Required	Description
X-Version	header	string	false	Version of the API (2022-01-01)
documentId	path	string	true	The unique identifier of the document
sectionId	path	string	true	The unique identifier of the section
body	body	SectionCopy	true	A SectionCopy object

Body parameter example#

{
  "document": "327afa1a152f372fa1aeadb35ed28925d",
  "sectionIndex": 2,
  "sectionName": "October 2020",
  "sectionParent": "327afa1a152f372fa1aeadb35ed28925d_1"
}

Code Samples#

curl

curl -X POST https://api.app.wdesk.com/platform/v1/documents/{documentId}/sections/{sectionId}/copy \
    -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/platform/v1/documents/{documentId}/sections/{sectionId}/copy \
    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/platform/v1/documents/{documentId}/sections/{sectionId}/copy" \
    --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/platform/v1/documents/{documentId}/sections/{sectionId}/copy', headers = headers)

print(r.headers['Location'])