Welcome

What is legesis?

legesis is a multi-tenant e-signature platform with a REST API, a SmartTag templating language for fields embedded in DOCX/PDF, and a postMessage-based iframe bridge for white-label embedding.

This documentation is the canonical reference for integrators. It is generated from the same OpenAPI spec the API server emits and is rebuilt on every production deploy.

Where to start

• Quickstart — make your first API call in under five minutes.
• Authentication — X-API-Key, scopes, idempotency.
• Envelope lifecycle — created → sent → opened → signed → completed.
• API reference — every endpoint and parameter, generated from the live OpenAPI spec.
• Iframe embed (coming in week 3) — drop legesis into your own product with one <iframe>.

Conventions

• The API base URL is https://app.legesis.com. Override it with the NEXT_PUBLIC_DOCS_API_BASE env when running docs against a non-production environment.
• Code samples default to cURL.
• Every state-changing endpoint (POST, PATCH, DELETE) requires an Idempotency-Key header. The server rejects calls without one.
• All timestamps are ISO 8601 UTC. All amounts are integers in the smallest currency unit (e.g. 2500 for $25.00).