Lucid

Lucid Folders API

Create, retrieve, update, search, trash, and restore folders. Includes listing folder contents and root folder navigation.

GitHub OpenAPI

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/folders/{id} Get a folder's details · Get Folder #
Ask an LLM
“What information can I get about a single Lucid folder?”
“Can I check a folder's name and parent by its ID?”
Tell an agent
Get folder {id}.
Show the details of folder {id}.
PATCH /v1/folders/{id} Rename or move a folder · Update Folder #
Ask an LLM
“How do I rename a folder?”
“What permissions do I need to move a folder to a new parent?”
Tell an agent
Rename folder {id} to {name}.
Move folder {id} under parent {parent}.
POST /v1/folders Create a new folder · Create Folder #
Ask an LLM
“Can I create a folder or team folder from code?”
“How do I make a new folder inside an existing one?”
Tell an agent
Create a {type} called {name}.
Create {type} {name} inside folder {parent}.
POST /v1/folders/{id}/trash Move a folder and its contents to the trash · Trash Folder #
Ask an LLM
“Does trashing a folder also trash everything in it?”
“Can I send a whole folder to the trash?”
Tell an agent destructive · confirm first
Trash folder {id}.
Move folder {id} and its contents to the trash.
POST /v1/folders/{id}/restore Restore a trashed folder · Restore Folder #
Ask an LLM
“Can I bring back a folder I trashed?”
“Where do a restored folder's contents end up?”
Tell an agent
Restore folder {id} from the trash.
Undo the trashing of folder {id}.
POST /v1/folders/search Search folders I can access · Search Folders #
Ask an LLM
“How do I find folders by keyword?”
“Can an admin search every folder on the account?”
Tell an agent
Search folders for {keywords} as {Lucid-Request-As}.
Find {type} folders owned by {ownedByUsers}, requesting as {Lucid-Request-As}.
GET /v1/folders/{id}/contents List what is inside a folder · List Folder Contents #
Ask an LLM
“What documents and subfolders are inside a given folder?”
“Can I list a folder's contents page by page?”
Tell an agent
List the contents of folder {id}.
Show the documents and subfolders in folder {id}.
GET /v1/folders/root/contents List the contents of my root folder · List Root Folder Contents #
Ask an LLM
“What's at the top level of my Lucid documents?”
“Which items sit in my root folder?”
Tell an agent
List my root folder contents.
Show what's at the top level of my documents.
GET /v1/folders/app/contents List my app's project folder contents · List App Folder Contents #
Ask an LLM
“What has my OAuth app saved in its own app folder?”
“How is the app project folder chosen for the listing?”
Tell an agent
List the contents of this app's project folder.
Show the documents my integration stored in its app folder.

Documentation

📖
Documentation
https://developer.lucid.co/docs/welcome
📖
APIReference
https://developer.lucid.co/reference/api
📖
APIReference
https://developer.lucid.co/reference/overview-scim

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lucid/refs/heads/main/openapi/lucid-folders-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/lucid:lucid-folders-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lucid-folders-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Lucid REST Folders API
  version: '1.0'
  description: The Lucid REST API provides programmatic access to manage documents, users, folders, sharing, licensing, and audit logs across the Lucid Suite (Lucidchart, Lucidspark, and Lucidscale). Authenticate via OAuth 2.0 or API key.
  contact:
    name: Lucid Developer Platform
    url: https://developer.lucid.co/
  x-documentation: https://developer.lucid.co/reference/api
servers:
- url: https://api.lucid.co
tags:


# --- truncated at 32 KB (38 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lucid/refs/heads/main/openapi/lucid-folders-api-openapi.yml