A common business need is to draft a finalized document, and later create a very similar new document with only minor value changes.
Instead of starting from scratch, you can implement this as a duplication flow with session export and import.
Typical usage:
- End-user finalizes the original document.
- Your backend exports the builder session with
GET /api/builder/sessions/{session_id}/export. - You store the ZIP archive in your own storage.
- When the end-user clicks "Duplicate", your backend imports the archive with
POST /api/builder/sessions/importand creates a new builder session. - You redirect the end-user to the new session URL and they adjust only the values that differ.
Important behavior:
- Import always creates a completely new builder session.
- The original exported session remains unchanged.
- Handlers are integration-specific and must be provided again on import.