figma-common-errors

# Figma Common Errors ## Overview Quick reference for the most common Figma REST API and Plugin API errors, with exact error messages and working solutions. ## Prerequisites - Figma API credentials configured - Access to your application logs or browser console ## Instructions ### Step 1: Identify the Error Category #### REST API HTTP Errors | Status | Error | Cause | Solution | |--------|-------|-------|----------| | 400 | Bad Request | Malformed request, invalid node IDs | Verify node ID format (`pageId:nodeId`, e.g., `0:1`) | | 403 | Forbidden | Invalid token, wrong scopes, no file access | Regenerate PAT with correct scopes; verify file sharing | | 404 | Not Found | Wrong file key, deleted file, wrong endpoint | Check file key from URL; verify file exists | | 429 | Rate Limited | Too many requests | Read `Retry-After` header; implement backoff | | 500 | Internal Server Error | Figma server issue | Retry with exponential backoff; check status.figma.com | ### Step 2: Diagnose Specific Errors #### 403 Forbidden -- Token Issues ```bash # Test your token curl -s -o /dev/null -w "%{http_code}" \ -H "X-Figma-Token: ${FIGMA_PAT}" \ https://api.figma.com/v1/me # 200 = token valid, 403 = invalid/expired # Check what scopes your request needs # file_content:read -> GET /v1/files/:key # file_comments:read -> GET /v1/files/:key/comments # file_variables:read -> GET /v1/files/:key/variables/local # webhooks:write -> POST /v2/webhooks ``` Common 403 causes: - PAT expi...