GUIDESetupLucidchart
Lucidchart Integration
Connect rkito to Lucidchart to sync architecture diagrams and extract Ledger entities — Systems, Components, and Interfaces — through AI analysis.
Before you start
- Access to the Lucid Developer Portal
- Your API domain
- The Client ID and Client Secret from your Lucid app
What rkito uses Lucidchart for
| Feature | Mechanism |
|---|---|
| Document sync | OAuth 2.0 — lists documents from the user's Lucidchart account |
| Diagram ingestion | OAuth 2.0 — reads diagram content (shapes, connections, labels) |
| Entity extraction | LLM analysis of diagram content → System/Component/Interface records in the Ledger |
Create the Lucidchart OAuth app
- Go to the
Lucid Developer Portalatlucid.app/developer - Click
Create new app - Fill in: Application name (
rkito), Application URL (https://app.yourdomain.com)
Configure OAuth 2.0
- In your app, find the
OAuth 2.0section - Add a Redirect URI:
Environment Redirect URI Production https://api.yourdomain.com/api/v1/integrations/lucidchart/oauth/callback - Note the
Client IDandClient Secret
Configure OAuth scopes
| Scope | Why |
|---|---|
| lucidchart.document.content:read | Read diagram shapes, connections, and labels |
| lucidchart.document.metadata:read | Read document titles, thumbnails, edit URLs |
| offline_access | Issue a refresh token for long-lived access |
Scope names may vary — check the current Lucid Developer Portal for the canonical list.
Set environment variables
api/.env
# api/.env
LUCIDCHART_CLIENT_ID=<Client ID from Lucid Developer Portal>
LUCIDCHART_CLIENT_SECRET=<Client Secret from Lucid Developer Portal>
LUCIDCHART_REDIRECT_URI=https://api.yourdomain.com/api/v1/integrations/lucidchart/oauth/callbackConnect from rkito
- In rkito, navigate to your org →
Integrations → Lucidchart - Click
+ Connect→Connect Lucidchart - The Lucidchart OAuth page opens — log in and authorise rkito
- You are redirected back — the new integration appears with status
ACTIVE - Click the integration →
Sync documentsto pull your diagram list - Documents appear — click
Ingeston a diagram to start AI entity extraction
Token refresh
Lucidchart access tokens expire. If a sync or ingest fails with a 401, the integration status is set to ERROR. Reconnect by clicking + Connect — the existing record is updated with new tokens.
Troubleshooting
redirect_uri_mismatch
LUCIDCHART_REDIRECT_URI must be identical to the Redirect URI in the Lucid Developer Portal.
401 Unauthorized on sync or ingest
The stored access token has expired. Reconnect the integration from the Lucidchart integrations page.
Ingestion extracts no entities
The LLM extracts entities from shape text labels. Diagrams with only icons and no text labels produce empty results — add labels to your shapes.
Was this guide helpful?