v1

latestOpenAPI 3.0.3Lucid2026-07-14155181312.3 KB
Folders

List Folder Contents

Retrieves basic information about the contents of a given folder. Results are paginated.

get/v1/folders/{id}/contents

Path parameters

number required
OR
'root' required

ID of the folder or root to retrieve contents of the authenticated user's root directory ("My Documents").

Response

OK with an array of Folder Content Resources containing information about the contents of the requested folder.

type'folder' | 'document' required
  • folder - Type denoting that the Folder Content Resource is a folder and will have a Number id field and no product field.
  • document - Type denoting that the Folder Content Resource is a document and will have a UUID id field and will contain a product field.
namestring required

Name of the folder or document

isShortcutboolean required

A boolean value indicating whether or not the folder or document is a shortcut.

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

The Lucid Suite product that a document was created in.

Example response

[
  {
    "type": "document",
    "name": "Folder Name",
    "product": "lucidchart"
  }
]