lucidchart-common-errors

# 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 t...