Changelog
API version history, new features, and breaking changes.
v2.0.0 Breaking — March 2026
Multi-Party Contracts & V1 Removal
V2 is a complete rewrite of the external API. V1 has been removed and is no longer available.
New Features
- Multi-party contracts — Create contracts with 2+ parties via the
parties[]array. Each party has arole,legalName, andemail. - Automatic signing emails — Draftory sends signing notification emails to all parties when a contract is created.
- Signing progress tracking — Responses include
signingProgresswithsigned,total,pending, andpercentagefields. - Per-party signing status — GET endpoint returns
parties[].hasSignedboolean for each party. - Contract numbers — Each contract receives a human-readable
contractNumber(e.g.EXT-20260321-ABCDEFGH). - Signature details — GET endpoint includes full
signatures[]array withsignerEmail,signerName,signerRole, andsignedAt. - New status:
partially_signed— Indicates at least one but not all parties have signed.
Breaking Changes
- Breaking Base URL changed from
/api/external/v1to/api/external/v2 - Breaking Request body uses
parties[]array instead ofrecipientEmail,recipientName,businessName - Breaking
contentis now a plain text string instead of a JSON object - Breaking
autoSignparameter removed — V2 uses multi-party signature counting - Breaking
GET /contracts(list) endpoint removed — use individual contract lookup - Breaking
GET /contracts/:id/pdfendpoint removed from external API - Breaking
senderNamereplacesbusinessNameas the display name in emails - Breaking V1 API (
/api/external/v1) is fully removed and returns 404
Migration Guide
| V1 | V2 |
|---|---|
recipientEmail + recipientName | parties: [{ role, legalName, email }] |
businessName | senderName |
content: { title: "..." } | content: "TITLE\n\n1. SECTION..." |
autoSign: true | Removed (all parties sign individually) |
GET /contracts (list) | Removed |
GET /contracts/:id/pdf | Removed from external API |
status: "draft" | status: "pending_signature" (contracts start in this state) |
v1.0.0 Deprecated — March 2026
Initial Release — Removed in v2.0.0
- Single-recipient contract creation with 8 contract types
- Contract listing with status filtering and pagination
- Contract detail retrieval with decrypted content
- PDF download for signed contracts
- Usage and quota monitoring
- API health check
Future entries will follow the format: version number, date, list of changes, and a Breaking badge for breaking changes.