Skip to main content

documenso-common-errors

Diagnoses and resolves common Documenso API errors, providing quick fixes for integration issues and troubleshooting failed operations.

Install this skill

or
47/100

Security score

The documenso-common-errors skill was audited on May 12, 2026 and we found 25 security issues across 4 threat categories. Review the findings below before installing.

Categories Tested

Security Issues

medium line 61

Template literal with variable interpolation in command context

SourceSKILL.md
61headers: { "Authorization": `Bearer ${process.env.DOCUMENSO_API_KEY}` },
medium line 94

Template literal with variable interpolation in command context

SourceSKILL.md
94throw new Error(`Cannot modify document in ${doc.status} status. Cancel first or create new.`);
medium line 143

Template literal with variable interpolation in command context

SourceSKILL.md
143throw new Error(`PDF is ${fileSizeMB.toFixed(1)}MB, max is ${MAX_SIZE_MB}MB`);
medium line 192

Curl to non-GitHub URL

SourceSKILL.md
192curl -s https://your-instance.com/api/health
low line 55

Fetch to external URL

SourceSKILL.md
55const res = await fetch("https://app.documenso.com/api/v1/documents", {
low line 60

Fetch to external URL

SourceSKILL.md
60const res = await fetch("https://app.documenso.com/api/v1/documents", {
medium line 29

Webhook reference - potential data exfiltration

SourceSKILL.md
29Quick-reference troubleshooting guide for Documenso API errors. Covers authentication, document lifecycle, field validation, file upload, webhook, and SDK-specific issues with concrete solutions.
medium line 147

Webhook reference - potential data exfiltration

SourceSKILL.md
147### Scenario 6: Webhook Not Receiving Events
low line 151

Webhook reference - potential data exfiltration

SourceSKILL.md
1511. Webhook URL uses HTTPS (HTTP is rejected)
low line 152

Webhook reference - potential data exfiltration

SourceSKILL.md
1522. Webhook is enabled in Team Settings > Webhooks
medium line 155

Ngrok tunnel reference

SourceSKILL.md
1555. If using ngrok: tunnel is active and URL matches dashboard config
low line 56

Access to .env file

SourceSKILL.md
56headers: { "Authorization": process.env.DOCUMENSO_API_KEY! }, // Missing "Bearer "
low line 61

Access to .env file

SourceSKILL.md
61headers: { "Authorization": `Bearer ${process.env.DOCUMENSO_API_KEY}` },
low line 66

Access to .env file

SourceSKILL.md
66const client = new Documenso({ apiKey: process.env.DOCUMENSO_API_KEY! });
low line 81

Access to .env file

SourceSKILL.md
81apiKey: process.env.DOCUMENSO_TEAM_API_KEY!, // Team-scoped key
low line 47

External URL reference

SourceSKILL.md
47| 500/502/503 | Server Error | Documenso infrastructure issue | Retry with exponential backoff; check [status.documenso.com](https://status.documenso.com) |
low line 55

External URL reference

SourceSKILL.md
55const res = await fetch("https://app.documenso.com/api/v1/documents", {
low line 60

External URL reference

SourceSKILL.md
60const res = await fetch("https://app.documenso.com/api/v1/documents", {
low line 189

External URL reference

SourceSKILL.md
189https://app.documenso.com/api/v1/documents?page=1&perPage=1
low line 192

External URL reference

SourceSKILL.md
192curl -s https://your-instance.com/api/health
low line 196

External URL reference

SourceSKILL.md
196"https://app.documenso.com/api/v1/documents?page=1&perPage=5" | jq '.documents[].title'
low line 203

External URL reference

SourceSKILL.md
203| `ERR_INVALID_URL` | Bad `serverURL` in SDK config | Include protocol and path: `https://host/api/v2` |
low line 210

External URL reference

SourceSKILL.md
210- [Documenso API Reference](https://openapi.documenso.com/)
low line 211

External URL reference

SourceSKILL.md
211- [Status Page](https://status.documenso.com)
low line 213

External URL reference

SourceSKILL.md
213- [Documenso Discord](https://documenso.com/discord)
Scanned on May 12, 2026
View Security Dashboard
Installation guide →