lucidchart-common-errors
Installation
SKILL.md
Lucidchart Common Errors
Overview
Lucidchart's API enables programmatic diagram creation, document management, shape manipulation, and team collaboration workflows. Common integration errors include OAuth token expiration during long-running batch operations, document lock conflicts when multiple users edit simultaneously, and shape API 422 errors from invalid geometry or missing parent references. The OAuth token refresh flow is the most common stumbling block -- access tokens expire after 60 minutes, and batch operations that exceed this window fail mid-run. This reference covers authentication, document lifecycle, and shape-level validation issues for the Lucid developer platform.
Error Reference
| Code | Message | Cause | Fix |
|---|---|---|---|
401 |
Token expired |
OAuth2 access token expired | Use refresh token to obtain new access token |
403 |
Insufficient scopes |
OAuth app missing required permission scopes | Re-authorize with lucidchart.document.content and needed scopes |
404 |
Document not found |
Invalid document ID or user lacks access | Verify document ID and that API user has viewer/editor role |
409 |
Document locked |
Another user is actively editing | Wait for lock release or use force-unlock with admin privileges |
422 |
Invalid shape data |
Shape position/size out of bounds or missing parent | Validate x/y/width/height > 0; ensure parent page exists |
422 |
Invalid connection |
Source or target shape ID does not exist | Create shapes before connecting them; verify shape IDs |
429 |
Rate limited |
Exceeded 100 requests/minute | Implement exponential backoff; batch shape operations |
500 |
Export failed |
PDF/PNG export timed out on complex diagram | Reduce page count or simplify shapes before export |