documenso-common-errors

# Documenso Common Errors ## Overview Quick-reference troubleshooting guide for Documenso API errors. Covers authentication, document lifecycle, field validation, file upload, webhook, and SDK-specific issues with concrete solutions. ## Prerequisites - Working Documenso integration (see `documenso-install-auth`) - Access to application logs - API key available ## HTTP Error Reference | Status | Error | Cause | Solution | |--------|-------|-------|----------| | 401 | Unauthorized | Invalid, expired, or missing API key | Regenerate key in dashboard; verify `Authorization: Bearer <key>` header | | 403 | Forbidden | Personal key accessing team resources | Use a team-scoped API token | | 404 | Not Found | Wrong document/template ID or deleted resource | Verify ID with `GET /api/v1/documents` | | 400 | Bad Request | Invalid payload or missing required fields | Check request body against API spec | | 413 | Payload Too Large | PDF exceeds upload limit | Compress PDF; cloud plan limit varies by tier | | 429 | Too Many Requests | Rate limit exceeded | Implement backoff; see `documenso-rate-limits` | | 500/502/503 | Server Error | Documenso infrastructure issue | Retry with exponential backoff; check [status.documenso.com](https://status.documenso.com) | ## Instructions ### Scenario 1: 401 Unauthorized ```typescript // WRONG: missing or malformed header const res = await fetch("https://app.documenso.com/api/v1/documents", { headers: { "Authorization": process.env.DOCUMENSO_AP...