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 |
rkito requests read-only access. It never modifies your Lucidchart documents.
1. Create the Lucidchart OAuth app
1
Go to the Lucid Developer Portal at lucid.app/developer
2
Click Create new app
3
Fill in: Application name (rkito), Application URL (https://app.yourdomain.com)
2. Configure OAuth 2.0
1
In your app, find the OAuth 2.0 section
2
Add a Redirect URI:
| Environment | Redirect URI |
|---|---|
| Production | https://api.yourdomain.com/api/v1/integrations/lucidchart/oauth/callback |
3
Note the Client ID and Client Secret
3. 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.
4. Set environment variables
# 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/callback
5. Connect from rkito
1
In rkito, navigate to your org → Integrations → Lucidchart
2
Click + Connect → Connect Lucidchart
3
The Lucidchart OAuth page opens — log in and authorise rkito
4
You are redirected back — the new integration appears with status ACTIVE
5
Click the integration → Sync documents to pull your diagram list
6
Documents appear — click Ingest on 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.
Common errors
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.