{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Finalize confirmation dialog"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"finalize-confirmation-dialog","__idx":0},"children":["Finalize confirmation dialog"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before a document is finalized, the Builder UI shows a confirmation dialog. By default it displays a generic confirmation message:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/finalize-confirmation-dialog.0f1187a774b62b804f33a83922d10d39ed3010548cf78f93f1cab412c5496abc.c5aff763.png","alt":"Default finalize confirmation dialog"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can control this dialog with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalization"]}," object when creating or updating a builder session."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["How to use:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a builder session with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalization"]}," object in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/builder/sessions"]}," (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/embed-api/openapi/builder/createbuildersession"},"children":["endpoint docs"]},"), or update an existing session via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/builder/sessions/{session_id}"]}," (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/embed-api/openapi/builder/updatebuildersession"},"children":["endpoint docs"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmation_enabled"]}," to control whether the confirmation dialog is shown before finalization."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmation_text"]}," to replace the default message with your own. HTML is supported with the allowed tags ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["strong"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["b"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wbr"]},". When omitted, the default confirmation copy is used."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"finalization\": {\n    \"confirmation_enabled\": true,\n    \"confirmation_text\": \"<strong>Please review carefully.</strong> This action cannot be undone.\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When trial mode is enabled (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["trial"]}," is not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalization"]}," settings are ignored."," ","Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalization"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/builder/sessions/{session_id}"]}," to clear previously set finalization settings and restore the default dialog."]}]},"headings":[{"value":"Finalize confirmation dialog","id":"finalize-confirmation-dialog","depth":1}],"frontmatter":{"seo":{"title":"Finalize confirmation dialog"}},"lastModified":"2026-08-28T07:01:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/embed-api/legal-engine/finalize-confirmation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}