Lucid
Move briefs, assets and sign-offs through Lucid without chasing between tools.
13 ways to read, 5 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Lucid, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create document from template
documents.createApproval by rule - Create folder
folders.createApproval by rule - List account users
account_users.listRead
Example flow
- Lucid · List account users
account_users.listDone - Lucid · Create document from template
documents.createMaker-checker - Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Lucid.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Lucid
- Lucid's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Lucid REST API for Lucidchart, Lucidspark and Lucidscale: search and read documents and their contents, folders, collaborators, comment threads and users; copy templates, organise folders and comment.
Lucid Software Inc. API docs- Source actions
- 13
- Destination actions
- 5
- Data types
- 9
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
account users3
- Get account userSource
One user on the authorised account.
- List account usersSource
Users on the authorised account (account token or admin scope).
- Find users by emailSource
Users on the account whose email exactly matches (sent in the request body).
comment threads1
- List comment threadsSource
Comment threads on a document with status.
document collaborators1
- List document collaboratorsSource
Users with access to a document and their roles.
document pages1
- List document pagesSource
Pages of a Lucidchart or Lucidspark document with shape, line and group counts and their text.
documents5
- Create document from templateDestinationNot retried automaticallyApproval before production
Copy an existing document or template into a new document with a title, optionally in a folder.
- Get documentSource
Document metadata: title, product, links, version, pages, owner and attributes.
- List documentsSourceIncremental
Documents the user can read, oldest created first, with modified-time and product filters.
- Search documentsSource
Documents matching keywords, ranked by relevance.
- Update documentDestinationProvider duplicate protectionApproval before production
Rename a document, move it to another folder or repository, or set its tags.
folder contents1
- List folder contentsSource
Documents and sub-folders in a folder, or in the user's root folder.
folders3
- Create folderDestinationNot retried automaticallyApproval before production
Create a folder, optionally inside another folder.
- Get folderSource
Folder or team folder name, parent, repository and attributes.
- Update folderDestinationProvider duplicate protectionApproval before production
Rename a folder or move it under another folder.
thread comments2
- Post thread commentDestinationNot retried automaticallyApproval before production
Add a comment to an existing comment thread on a document.
- List thread commentsSource
Comments in a document's comment thread, with authors and assignees.
users1
- Get authorised userSource
The authorised user's profile: name, username, email and account.
Access and limits
- Authentication
- Lucid OAuth 2.0 client (user token with offline access; refresh tokens rotate)
- Plans and access
- Any Lucid account can create an OAuth 2.0 client in the Lucid developer portal. User and account management reads need an account (admin) token. User tokens act as the authorising user and see only documents and folders shared with them. Account-wide document search needs admin scopes.
- Test environment
- Lucid has no sandbox; authorise the OAuth client with a test Lucid account.
- Rate limits
- 15 requests per second per user token and 50 per account token; document and folder search are limited to 300 requests per 5 seconds per account. HTTP 429 includes Retry-After in seconds.
- Pagination
- Paginated endpoints take pageSize (up to 200) and return a Link rel="next" URL with an opaque pageToken; Nexra follows it.
- Provider events
- Lucid does not offer webhooks on the REST API. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- No deletes or trashing: Nexra never trashes documents or folders, removes collaborators or deletes share links.
- No sharing changes: Nexra does not create, update or accept share links, or add or change collaborators, so content is never made public.
- Document creation copies an existing document or template (POST /documents/copy). Creating from Standard Import JSON or an external file needs a file upload and is an engine gap, as is image export of documents.
- User list and lookup need an account token or admin scopes (account.user:readonly); a user token returns HTTP 403.
- Lucid documents the token endpoint with a JSON body; Nexra sends the standard form-encoded refresh request, which Lucid accepts (it parses form fields), but this content type is not documented.
- Document contents are summarised per page (shape, line and group counts and text); the full shape model is not mapped.
- Comment threads and comments are not paginated by Lucid.
Developer reference
- Create the Lucid Software Inc. credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Lucid, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/lucid and the Connections API.