Aller au contenu

Authentication & test mode

v1 · Last updated 2026-07-17

Cette documentation est disponible uniquement en anglais.

Authentication

Every /api/v1/* request needs a bearer token:

Authorization: Bearer pk_live_…

Keys are tenant-scoped and reach any workspace inside the tenant. Revoke from the dashboard at any time; revocation propagates within ~60s.

Test mode

Create a key with mode Test in Settings → API keys and it's prefixed pk_test_. Test keys hit the same endpoints with the same shapes, but the run is sandboxed:

  • Rendered PDFs carry a diagonal TEST watermark saying the document is not legally binding.
  • Nothing counts against render or sign-request quotas, and nothing is billed.
  • Signature requests are test requests: signers get real emails marked [Test], the signing page and the PDF say the document is not legally binding, the request is signable for 24 hours and the signed copy is deleted 24 hours after signing. No webhooks are sent. The response also carries the sign link(s) directly (signUrl, and signUrls keyed by signer index).
  • A live key (or the dashboard) can send a test request too: pass test: true. The Free plan can only send test requests.
  • Artifacts expire after 1 hour, and async jobs are capped at 10 items.

Test rows are flagged testMode: true everywhere. Swap in a pk_live_ key and the same code goes to production.

Need help?

Open a ticket from the in-app Support page, or email [email protected].