{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Integration"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integration","__idx":0},"children":["Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The core of Legal Engine is the Builder. The Builder is a hosted UI to which you redirect your end-users. To start using the Builder, you need a template. You can allow your end-users to choose a template using our hosted Template Browser, or you can create your own customized template browser UI using our API."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What is template?"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Template is our proprietary format for defining a set of questions and logic to generate highly customizable and trustworthy legal documents. Each template belongs to one or more jurisdictions (usually just one as legal requirements differ across them), and can be available in multiple languages. For example, the Finnish Employment Agreement template is available in three languages: Finnish, English, and Swedish. The end-user can choose which language version they want to draft."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As part of your account setup, we can choose which templates are available via the API and via the Template Browser."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"template-browser","__idx":1},"children":["Template Browser"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To use the Template Browser, you must create a new browser session. Then, redirect your end-user to the provided URL. Once the end-user selects their template, they will be redirected back to the return URL you provided. In most cases, you will then immediately start a new ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Builder session"]}," using the provided data and redirect the user back to our UI."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n Integrator ->> Docue API: POST /api/browser/sessions\n Docue API ->> Integrator: Redirect url and session id\n Integrator ->> Docue UI: Redirect user to Template Browser\n Docue UI ->> Docue UI: User chooses the template\n Docue UI ->> Integrator: Redirect to provided return url with template id + language\n","diagramHtml":"","diagramHtmlDark":""},"children":["sequenceDiagram\n Integrator ->> Docue API: POST /api/browser/sessions\n Docue API ->> Integrator: Redirect url and session id\n Integrator ->> Docue UI: Redirect user to Template Browser\n Docue UI ->> Docue UI: User chooses the template\n Docue UI ->> Integrator: Redirect to provided return url with template id + language\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"builder","__idx":2},"children":["Builder"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To use the Builder, you must create a new builder session. Then, redirect your end user to the provided URL. Once the end user completes the document, they will be redirected back to the return URL you provided. After that, you can fetch the completed PDF and metadata, including the list of signees, using the API."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n Integrator ->> Docue API: POST /api/builder/sessions\n Docue API ->> Integrator: Redirect url and session id\n Integrator ->> Docue UI: Redirect user to builder\n activate Docue UI\n Docue UI ->> Docue UI: User updates the document\n Docue UI ->> Docue UI: User finalizes the document\n Docue UI ->> Integrator: Redirect to return url\n deactivate Docue UI\n Integrator ->> Docue API: Request PDF + metadata\n Docue API ->> Integrator: PDF + metadata\n","diagramHtml":"","diagramHtmlDark":""},"children":["sequenceDiagram\n Integrator ->> Docue API: POST /api/builder/sessions\n Docue API ->> Integrator: Redirect url and session id\n Integrator ->> Docue UI: Redirect user to builder\n activate Docue UI\n Docue UI ->> Docue UI: User updates the document\n Docue UI ->> Docue UI: User finalizes the document\n Docue UI ->> Integrator: Redirect to return url\n deactivate Docue UI\n Integrator ->> Docue API: Request PDF + metadata\n Docue API ->> Integrator: PDF + metadata\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the drafting UI redirects back to your service you can manage the document lifecycle via the Builder endpoints:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/builder/sessions/{session_id}"]}," to update builder session settings (for example, trial mode configuration)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/builder/sessions/{session_id}/contract"]}," to fetch the latest contract state."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/builder/sessions/{session_id}/contract/finalize"]}," to lock the document when it is ready."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/builder/sessions/{session_id}/contract/unfinalize"]}," to revert a finalized document back to an editable state."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/builder/sessions/{session_id}/html"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/builder/sessions/{session_id}/pdf"]}," to retrieve the rendered output."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/builder/sessions/{session_id}/export"]}," to export session data as ZIP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/builder/sessions/import"]}," to import an exported ZIP and create a new session."]}]}]},"headings":[{"value":"Integration","id":"integration","depth":1},{"value":"Template Browser","id":"template-browser","depth":2},{"value":"Builder","id":"builder","depth":2}],"frontmatter":{"seo":{"title":"Integration"}},"lastModified":"2026-08-28T07:01:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/embed-api/legal-engine/integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}