Agent skill · data analytics · jeremylongshore
documenso-common-errors
Diagnose and resolve common Documenso API errors and issues.
Why this skill is useful
Provides specific troubleshooting patterns and solutions for common Documenso API errors that the AI wouldn't reliably generate on its own.
What it needs
Requires documenso account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Documenso Common Errors Output A classified document/signing integration failure with redacted evidence and a bounded remediation or escalation. A verified recovery that preserves authorization, document integrity, signing lifecycle, and audit continuity. Examples For a failed signing action, record the opaque document/correlation ID, environment, lifecycle state, status class, and timestamp. Verify signer role, expiration, callback, and authorization with a synthetic fixture; escalate with redacted evidence if unresolved, rather than sharing the document or signing link. 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 Instructions Scenario 1: 401 Unauthorized Checklist: API key starts with api (personal) or is team-scoped No trailing whitespace or newline in env var Key hasn't been revoked in dashboard Scenario 2: 403 — Personal Key on Team Resources Scenario 3: Cannot Modify Sent Document (400) Scenario 4: Invalid Field Position (4 …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/documenso-common-errors--b6ef62