Sign in

v1

latestOpenAPI 3.0.3Lucid2026-07-14155181312.3 KB
Document Access

Copy Document

Copies one of the requesting user's existing documents, with the specified title. Requires title and template (the ID of the document to copy). Optionally, a parent folder can be provided. Note that collaborator permissions are not transferred to the copied document.

📘

This endpoint can only create a new Lucidchart or Lucidspark document. It cannot modify an existing document's contents.

📘 ##### Document Creation Location

When there is no parent field on the request, the new document will be created in a default location depending on the authorizing token's scopes.

  • If the token authorizing the request uses one of the document.app scopes, then the document will be created in an app-specific folder.
  • If one of the document.content scopes is used, the document will be created in the user's 'My Documents folder'.
  • If both types of scopes are authorized on the token, the document.content behavior will take priority and the document will be created in the user's 'My Documents' folder.

Valid Authentication Methods

API Key Grants:

  • DocumentEdit

OAuth 2.0 User Token Scopes:

  • lucidchart.document.content
  • lucidchart.document.app.folder
  • lucidspark.document.content
  • lucidspark.document.app.folder
post/v1/documents/copy

Request body

titlestring required

Title that should be given to the copied document.

templatestring uuid required

ID of the document to copy.

parentnumber

Folder ID for the new document.

Response

Created with Document resource containing information about the newly copied document.

documentIdstring uuid required

Unique ID of the document

titlestring required

Title of the document

editUrlstring uri required

Link to edit the document

viewUrlstring uri required

Link to view the document

versioninteger required

Most recent version

pageCountinteger required

Number of pages within the document

canEditboolean required

If requesting user can edit the document

createdstring date-time required

Date and time of when the document was created

creatorIdinteger required

ID of user who created and owns the document

lastModifiedstring date-time required

Date and time of when the document was last modified

lastModifiedUserIdinteger required

ID of user who most recently modified the document

customTagsstring[] required

List of any custom tags assigned to the document

product'lucidchart' | 'lucidscale' | 'lucidspark' required

The Lucid Suite product that a document was created in.

statusstring nullable

Current assigned status of the document

classificationstring nullable

Current assigned classification of the document

classificationIdstring uuid nullable

Current assigned classification ID of the document.

trashedstring date-time nullable

If defined, the timestamp when the document was moved to the trash

parentinteger nullable

ID of the parent folder

accountIdinteger nullable required

ID of Lucid account that owns the document

Example response

{
  "documentId": "110808fd-4553-4316-bccf-4f25ff59a532",
  "title": "document title",
  "editUrl": "https://lucid.app/lucidchart/110808fd-4553-4316-bccf-4f25ff59a532/edit",
  "viewUrl": "https://lucid.app/lucidchart/110808fd-4553-4316-bccf-4f25ff59a532/view",
  "version": 101,
  "pageCount": 5,
  "canEdit": false,
  "created": "2019-04-22T13:47:23Z",
  "creatorId": 12345,
  "lastModified": "2020-06-26T16:29:37Z",
  "lastModifiedUserId": 54321,
  "customAttributes": [],
  "customTags": [
    "in progress"
  ],
  "product": "lucidchart",
  "status": "Complete",
  "classification": "Private",
  "trashed": null,
  "parent": null,
  "repository": null,
  "owner": {
    "id": 123456,
    "type": "user",
    "name": "John Doe"
  },
  "accountId": 1234
}