Create or Copy Document

Create Document

Creates a new document for the requesting user, with the specified title. It supports only User token type.

Copy Document

A document can be copied via the Create Document endpoint. To do so, include the documentId of the desired document to be copied as the template parameter. Note that a document's collaborator permissions are not copied. It supports only User token type.

Import Document

Imports an external non-Lucid file as a new document within Lucid. The file contents and type must be provided within form-data, with the supported types listed in the below chart. It supports only User token type.

📘

This endpoint has a per account rate limit of 50 requests per minute.

Document Creation Location for Create Endpoint

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 Import Types for Import Endpoint

VendorExtensionTypeProducts
standard (JSON).lucidx-application/vnd.lucid.standardImportLucidchart/Lucidspark
draw.io.draw.io
.xml
x-application/vnd.lucid.drawioLucidchart
visio.vsdx
.vdx
x-application/vnd.lucid.visioLucidchart
gliffy.gliffy
.gon
.gxml
x-application/vnd.lucid.gliffyLucidchart
board.pdfx-application/vnd.lucid.boardLucidspark

📘

Important

The board import type only accepts pdfs that are exports of digital whiteboards.
The board import type can only be authorized by users with a Lucidspark Enterprise license.
The board import type is experimental and importing the same board may produce varying results over time.

📘

For more information on the standard import type, see our extensive documentation here.

Valid Access Token Types

User

Valid Access Scopes

lucidchart.document.content

lucidchart.document.app.folder

lucidspark.document.content

lucidspark.document.app.folder

Language
Authorization
OAuth2