{"items":[{"type":"link","label":"Embed API","link":"/embed-api/openapi","routeSlug":"/embed-api/openapi","content":{"contentType":"overview","meta":{"name":"Embed API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/embed-api/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/embed-api/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"URL","titleTranslationKey":"info.contact.url","label":"https://docue.com","url":"https://docue.com"},{"kind":"email","title":"E-mail","titleTranslationKey":"info.contact.name","email":"support@docue.com","label":"support@docue.com","withCopyButton":true,"copyContent":"support@docue.com"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Embed API (1.0.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[]}],"sectionId":"/embed-api/openapi"}],"sectionId":"/embed-api/openapi"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"section/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All endpoints in this API require Bearer authentication using an API key. Include the API key obtained from the customer portal in the Authorization header of each request, formatted as follows:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"Authorization: Bearer <api_key>\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Authorization: Bearer <api_key>\n"},"children":[]}]}]}],"sectionId":"/embed-api/openapi/section/authentication"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"section/base-urls"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Base URLs"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Legal Engine endpoints ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/api/..."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") are served from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://api.builder.docue.com"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and Sign Engine endpoints ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/sign/..."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://api.embed.docue.com"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The same API key works for both."},"children":[]}]}]}]}],"sectionId":"/embed-api/openapi/section/base-urls"}]}]}},{"type":"link","label":"Authentication","link":"/embed-api/openapi/section/authentication","routeSlug":"/embed-api/openapi/section/authentication","content":null},{"type":"link","label":"Base URLs","link":"/embed-api/openapi/section/base-urls","routeSlug":"/embed-api/openapi/section/base-urls","content":null},{"type":"group","label":"Workspaces","link":"/embed-api/openapi/workspaces","routeSlug":"/embed-api/openapi/workspaces","items":[{"label":"Get current workspace","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/workspaces/getcurrentworkspace","routeSlug":"/embed-api/openapi/workspaces/getcurrentworkspace","metadata":{"seo":{"title":"Get current workspace","description":"Get current workspace"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCurrentWorkspace","name":"Get current workspace","isWebhook":false,"pointer":"/paths/~1api~1workspaces~1current/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get current workspace","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1workspaces~1current/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/workspaces/current","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/workspaces/current","href":"workspaces/getcurrentworkspace","openApiOperationId":"getCurrentWorkspace","summary":"Get current workspace"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1api~1workspaces~1current/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_1","exampleIds":["paths/~1api~1workspaces~1current/get/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1api~1workspaces~1current/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1","exampleIds":["paths/~1api~1workspaces~1current/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1api~1workspaces~1current/get/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/workspaces/getcurrentworkspace"}],"panels":[]}]},"httpPath":"/api/workspaces/current"}],"content":{"contentType":"group","meta":{"name":"Workspaces"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Workspaces","showPageActions":true},{"nodeType":"markdoc","content":"Endpoint for fetching information about the authenticated workspace. It can be used to test if the API authentication works."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/workspaces/current","summary":"Get current workspace","prefix":{"name":"get","color":"get"},"badges":[],"link":"/workspaces/getcurrentworkspace","deprecated":false}]}]}]}]}},{"type":"group","label":"Templates","link":"/embed-api/openapi/templates","routeSlug":"/embed-api/openapi/templates","items":[{"label":"List templates","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/templates/gettemplates","routeSlug":"/embed-api/openapi/templates/gettemplates","metadata":{"seo":{"title":"List templates","description":"Fetch templates available for the authenticated workspace."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getTemplates","name":"List templates","isWebhook":false,"pointer":"/paths/~1api~1templates/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List templates","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fetch templates available for the authenticated workspace."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter[query]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to search templates by title with a partial, case-insensitive match."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /api/templates?filter[query]=employment"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter[collection]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to only return templates that belong to a specific collection ID."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /api/templates?filter[collection]=01965c7e-dc1e-7292-8199-8184041c1204"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can combine both filters in one request."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /api/templates?filter[query]=employment&filter[collection]=01965c7e-dc1e-7292-8199-8184041c1204"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To include template collections in each template item, request "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include=collections"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_2","description":"Number of items per page."},{"name":"page","in":"query","schemaId":"schema_3","description":"Page number to retrieve. Defaults to 1."},{"name":"filter[query]","in":"query","schemaId":"schema_4","description":"Filter templates by a partial match against the localized title.","example":"employment"},{"name":"filter[collection]","in":"query","schemaId":"schema_5","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter templates to those belonging to the specified template collection. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /api/template-collections"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to discover available collection IDs. Please note that a template may belong to multiple collections."},"children":[]}]}]}],"example":"01965c7e-dc1e-7292-8199-8184041c1204"},{"name":"sort","in":"query","schemaId":"schema_4","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sort order for the template list. Use the field name for ascending order, or prefix with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"-"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for descending order (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" sorts by localized title ascending; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"-title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" sorts descending)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Allowed sort fields: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"updated_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multiple sorts can be combined in one parameter as a comma-separated list (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sort=title,-created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When sorting by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sort_locale"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to control which translation is preferred for the comparison. If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sort_locale"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is omitted, the API compares titles using a fallback across all supported languages."},"children":[]}]}]}],"example":"title"},{"name":"sort_locale","in":"query","schemaId":"schema_6","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Locale code used when sorting by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": that language’s string is preferred when comparing titles (other languages are still used as fallback). Must be one of the supported Builder language codes. Ignored when the active sort does not use localized title."},"children":[]}]}]}],"example":"en-GB"},{"name":"include","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma delimited list of optional relationships to include. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available includes: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"collections"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"jurisdictions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"languages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"collections,languages,jurisdictions"}],"pointer":"/paths/~1api~1templates/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1templates/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/templates","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"example":20,"schemaId":"schema_2"},{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_3"},{"name":"filter[query]","in":"query","required":false,"example":"employment","schemaId":"schema_4"},{"name":"filter[collection]","in":"query","required":false,"example":"01965c7e-dc1e-7292-8199-8184041c1204","schemaId":"schema_5"},{"name":"sort","in":"query","required":false,"example":"title","schemaId":"schema_4"},{"name":"sort_locale","in":"query","required":false,"example":"en-GB","schemaId":"schema_6"},{"name":"include","in":"query","required":false,"example":"collections,languages,jurisdictions","schemaId":"schema_7"}],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/templates","href":"templates/gettemplates","openApiOperationId":"getTemplates","summary":"List templates"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response with a list of templates.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_8","exampleIds":["paths/~1api~1templates/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_8","exampleIds":["paths/~1api~1templates/get/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1api~1templates/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_8","exampleIds":["paths/~1api~1templates/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_8","exampleIds":["paths/~1api~1templates/get/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/templates/gettemplates"}],"panels":[]}]},"httpPath":"/api/templates"},{"label":"List template collections","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/templates/gettemplatecollections","routeSlug":"/embed-api/openapi/templates/gettemplatecollections","metadata":{"seo":{"title":"List template collections","description":"Fetch the available template collections."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getTemplateCollections","name":"List template collections","isWebhook":false,"pointer":"/paths/~1api~1template-collections/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List template collections","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fetch the available template collections."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To fetch templates that belong to a collection, refer to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /api/templates"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint and use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter[collection]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_2","description":"Number of items per page."},{"name":"page","in":"query","schemaId":"schema_3","description":"Page number to retrieve. Defaults to 1."},{"name":"filter[query]","in":"query","schemaId":"schema_4","description":"Filter collections by a partial match against the localized title.","example":"HR"},{"name":"sort","in":"query","schemaId":"schema_4","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sort order for the template collection list. Use the field name for ascending order, or prefix with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"-"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for descending order (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" sorts by localized title ascending; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"-title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" sorts descending)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Allowed sort fields: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"updated_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When sorting by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sort_locale"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to control which translation is preferred for the comparison. If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sort_locale"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is omitted, the API compares titles using a fallback across all supported languages."},"children":[]}]}]}],"example":"title"},{"name":"sort_locale","in":"query","schemaId":"schema_6","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Locale code used when sorting by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": that language’s string is preferred when comparing titles (other languages are still used as fallback). Must be one of the supported Builder language codes. Ignored when the active sort does not use localized title."},"children":[]}]}]}],"example":"en-GB"}],"pointer":"/paths/~1api~1template-collections/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1template-collections/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/template-collections","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","required":false,"example":20,"schemaId":"schema_2"},{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_3"},{"name":"filter[query]","in":"query","required":false,"example":"HR","schemaId":"schema_4"},{"name":"sort","in":"query","required":false,"example":"title","schemaId":"schema_4"},{"name":"sort_locale","in":"query","required":false,"example":"en-GB","schemaId":"schema_6"}],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/template-collections","href":"templates/gettemplatecollections","openApiOperationId":"getTemplateCollections","summary":"List template collections"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response with a list of template collections.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_9","exampleIds":["paths/~1api~1template-collections/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_9","exampleIds":["paths/~1api~1template-collections/get/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1api~1template-collections/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_9","exampleIds":["paths/~1api~1template-collections/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_9","exampleIds":["paths/~1api~1template-collections/get/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/templates/gettemplatecollections"}],"panels":[]}]},"httpPath":"/api/template-collections"},{"label":"Get a single template","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/templates/gettemplatebyid","routeSlug":"/embed-api/openapi/templates/gettemplatebyid","metadata":{"seo":{"title":"Get a single template","description":"Fetch one template by ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getTemplateById","name":"Get a single template","isWebhook":false,"pointer":"/paths/~1api~1templates~1{template_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a single template","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fetch one template by ID."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include=collections"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to include the template's collection memberships. You can also include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"languages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"jurisdictions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"template_id","in":"path","schemaId":"schema_10","description":"The UUID of the template to retrieve.","required":true}],"pointer":"/paths/~1api~1templates~1{template_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma delimited list of optional relationships to include. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available includes: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"collections"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"jurisdictions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"languages"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"collections,languages,jurisdictions"}],"pointer":"/paths/~1api~1templates~1{template_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1templates~1{template_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/templates/{template_id}","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"template_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[{"name":"include","in":"query","required":false,"example":"collections,languages,jurisdictions","schemaId":"schema_7"}],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/templates/{template_id}","href":"templates/gettemplatebyid","openApiOperationId":"getTemplateById","summary":"Get a single template"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved the template.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11","exampleIds":["paths/~1api~1templates~1{template_id}/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_11","exampleIds":["paths/~1api~1templates~1{template_id}/get/responses/200/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1templates~1{template_id}/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1templates~1{template_id}/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1templates~1{template_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_11","exampleIds":["paths/~1api~1templates~1{template_id}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11","exampleIds":["paths/~1api~1templates~1{template_id}/get/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1templates~1{template_id}/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1templates~1{template_id}/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/templates/gettemplatebyid"}],"panels":[]}]},"httpPath":"/api/templates/{template_id}"}],"content":{"contentType":"group","meta":{"name":"Templates"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Templates","showPageActions":true},{"nodeType":"markdoc","content":"Fetch a list of all available templates. Use this if you want to create a fully customized UI for selecting templates. If you prefer to use our ready-made UI, you can use the Template Browser instead."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/templates","summary":"List templates","prefix":{"name":"get","color":"get"},"badges":[],"link":"/templates/gettemplates","deprecated":false},{"title":"/api/template-collections","summary":"List template collections","prefix":{"name":"get","color":"get"},"badges":[],"link":"/templates/gettemplatecollections","deprecated":false},{"title":"/api/templates/{template_id}","summary":"Get a single template","prefix":{"name":"get","color":"get"},"badges":[],"link":"/templates/gettemplatebyid","deprecated":false}]}]}]}]}},{"type":"group","label":"Template browser","link":"/embed-api/openapi/template-browser","routeSlug":"/embed-api/openapi/template-browser","items":[{"label":"Create a new browser session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/template-browser/createbrowsersession","routeSlug":"/embed-api/openapi/template-browser/createbrowsersession","metadata":{"seo":{"title":"Create a new browser session","description":"To use our template browser for selecting the correct template, create a new browser session and redirect the end user to our app. Our app will then redirect the user back to your app to the URL defined in the handlers."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createBrowserSession","name":"Create a new browser session","isWebhook":false,"pointer":"/paths/~1api~1browser~1sessions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new browser session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To use our template browser for selecting the correct template, create a new browser session and redirect the end user to our app. Our app will then redirect the user back to your app to the URL defined in the handlers."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By creating a new browser session, you receive a redirect URL to send the end user. You also obtain a browser session ID, which allows you to retrieve the selected template, language, and the document title provided by the end user."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The redirect URL is a secure link to our hosted app. It contains a one-time authorization token to authenticate the end user securely. Our app exchanges the token for a session cookie, granting access to this specific browser session only."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The session expires after 15 minutes if the user has not been redirected to the URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"template-browser/createbrowsersession/request/handlers","deepLinkHash":"/template-browser/createbrowsersession#template-browser/createbrowsersession/request/handlers"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Handlers"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When creating a browser session, you must provide handler URLs."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Success handler"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user is redirected to this URL after successfully selecting the template and other details. Please note that the user may be redirected to this URL multiple times if they navigate back to the session using the browser's history."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cancel handler"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user is redirected to this URL when they intentionally cancel the template selection by clicking the \"back button\" in the header. They can continue using the template browser if they navigate back to the session using the browser's history; therefore, this may be called multiple times."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Delete handler"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user is redirected to this URL when the browser session expires or is deleted via the API. In many cases, it is acceptable to use the same endpoint as in the cancel handler. This may be called multiple times."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handler"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user is redirected to this URL when something unexpected occurs."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"template-browser/createbrowsersession/request/handler-url-parameters","deepLinkHash":"/template-browser/createbrowsersession#template-browser/createbrowsersession/request/handler-url-parameters"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Handler url parameters"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The handler URL is appended (existing query parameters will remain intact) with the following query parameters:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Parameter"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"session_id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Template browser session ID"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"template_id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the selected template (only on success)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"document_name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name the end-user choosed for the document (only on success)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"languages[0]"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Primary language of the document    (only on success)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"languages[1]"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Secondary language of the document (only on success, optional)"},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example, if you have defined success handler:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"\"success_handler\": {\n  \"endpoint\": \"https://example.com?handler=success\",\n  \"method\": \"GET\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"\"success_handler\": {\n  \"endpoint\": \"https://example.com?handler=success\",\n  \"method\": \"GET\"\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user will be redirected to URL:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"https://example.com?handler=success&session_id=0195c6eb-99ae-73c1-94f0-1763b872735d&template_id=0195c6eb-99ae-73c1-cc3a-1763b8743333d&language[0]=en-GB&document_name=Employment%20Agreement\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"https://example.com?handler=success&session_id=0195c6eb-99ae-73c1-94f0-1763b872735d&template_id=0195c6eb-99ae-73c1-cc3a-1763b8743333d&language[0]=en-GB&document_name=Employment%20Agreement\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In most cases, you want to immediately start a new "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"builder session"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" using the provided data and redirect the user back to our UI."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1browser~1sessions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBrowserSessionPayload","exampleIds":["paths/~1api~1browser~1sessions/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/CreateBrowserSessionPayload","exampleIds":["paths/~1api~1browser~1sessions/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1browser~1sessions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/browser/sessions","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateBrowserSessionPayload","exampleIds":["paths/~1api~1browser~1sessions/post/requestBody/content/application~1json/example"]}},"responseCodes":["201"],"pointer":"/api/browser/sessions","href":"template-browser/createbrowsersession","openApiOperationId":"createBrowserSession","summary":"Create a new browser session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"schemaId":"components/schemas/CreateBrowserSessionPayload","exampleIds":["paths/~1api~1browser~1sessions/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBrowserSessionPayload","exampleIds":["paths/~1api~1browser~1sessions/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response with details about the browser session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_12","exampleIds":["paths/~1api~1browser~1sessions/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_12","exampleIds":["paths/~1api~1browser~1sessions/post/responses/201/content/application~1json/example"]}],"pointer":"/paths/~1api~1browser~1sessions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_12","exampleIds":["paths/~1api~1browser~1sessions/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_12","exampleIds":["paths/~1api~1browser~1sessions/post/responses/201/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/template-browser/createbrowsersession"}],"panels":[]}]},"httpPath":"/api/browser/sessions"},{"label":"Retrieve details of existing browser session","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/template-browser/getbrowsersession","routeSlug":"/embed-api/openapi/template-browser/getbrowsersession","metadata":{"seo":{"title":"Retrieve details of existing browser session","description":"Returns details of the existing browser session. This information can serve as the source of truth when the user is redirected to your success handler."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBrowserSession","name":"Retrieve details of existing browser session","isWebhook":false,"pointer":"/paths/~1api~1browser~1sessions~1{session_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve details of existing browser session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns details of the existing browser session. This information can serve as the source of truth when the user is redirected to your success handler.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session to retrieve.","required":true}],"pointer":"/paths/~1api~1browser~1sessions~1{session_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1browser~1sessions~1{session_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/browser/sessions/{session_id}","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/browser/sessions/{session_id}","href":"template-browser/getbrowsersession","openApiOperationId":"getBrowserSession","summary":"Retrieve details of existing browser session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved the session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_13","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_13","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/get/responses/200/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1browser~1sessions~1{session_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_13","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_13","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/get/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/template-browser/getbrowsersession"}],"panels":[]}]},"httpPath":"/api/browser/sessions/{session_id}"},{"label":"Delete browser session","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/template-browser/deletebrowsersession","routeSlug":"/embed-api/openapi/template-browser/deletebrowsersession","metadata":{"seo":{"title":"Delete browser session","description":"Invalidates the browser session. The session remains accessible through the API for a limited time before it is permanently deleted. If the end user is still viewing the page, they will be redirected to the delete handler URL you specified."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteBrowserSession","name":"Delete browser session","isWebhook":false,"pointer":"/paths/~1api~1browser~1sessions~1{session_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete browser session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalidates the browser session. The session remains accessible through the API for a limited time before it is permanently deleted. If the end user is still viewing the page, they will be redirected to the delete handler URL you specified."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"There is no need to delete completed sessions; they will be automatically pruned after a certain period."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session to delete.","required":true}],"pointer":"/paths/~1api~1browser~1sessions~1{session_id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1browser~1sessions~1{session_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/browser/sessions/{session_id}","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/browser/sessions/{session_id}","href":"template-browser/deletebrowsersession","openApiOperationId":"deleteBrowserSession","summary":"Delete browser session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully deleted the session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_13","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/delete/responses/200/content/application~1json/example"]}},"schemaId":"schema_13","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/delete/responses/200/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1browser~1sessions~1{session_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_13","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/delete/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_13","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/delete/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1browser~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/template-browser/deletebrowsersession"}],"panels":[]}]},"httpPath":"/api/browser/sessions/{session_id}"}],"content":{"contentType":"group","meta":{"name":"Template browser"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Template browser","showPageActions":true},{"nodeType":"markdoc","content":"Hosted UI for end users to select the appropriate template. Use this if you want to take advantage of our UI."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/browser/sessions","summary":"Create a new browser session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/template-browser/createbrowsersession","deprecated":false},{"title":"/api/browser/sessions/{session_id}","summary":"Retrieve details of existing browser session","prefix":{"name":"get","color":"get"},"badges":[],"link":"/template-browser/getbrowsersession","deprecated":false},{"title":"/api/browser/sessions/{session_id}","summary":"Delete browser session","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/template-browser/deletebrowsersession","deprecated":false}]}]}]}]}},{"type":"group","label":"Builder","link":"/embed-api/openapi/builder","routeSlug":"/embed-api/openapi/builder","items":[{"label":"Create a new builder session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/createbuildersession","routeSlug":"/embed-api/openapi/builder/createbuildersession","metadata":{"seo":{"title":"Create a new builder session","description":"A builder session is required to start drafting a document in the Builder through the Embed API. Each session is isolated and contains all document-related data. Once the session ends, all data is deleted from our servers."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createBuilderSession","name":"Create a new builder session","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new builder session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A builder session is required to start drafting a document in the Builder through the Embed API. Each session is isolated and contains all document-related data. Once the session ends, all data is deleted from our servers."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To create a session, you need:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A template ID - Get this from our Template Listing API or let the end-user pick one via the hosted Template Browser UI."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of languages - The languages must match the languages available for the selected template. The language determines the final document's language that the end-user drafts. Currently, only one language can be provided."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A document name - Acts like a file name. It's shown in the builder UI and can be edited by the end-user."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Participant details"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can provide end-user details, such as display name and email, for your reference. These will be required later for collaboration features like commenting, but they are not currently in use. You can use the External ID field to store your internal user ID, which you can later use to match our participants with your users if needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Trial mode"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can optionally enable trial mode by providing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"trial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" configuration in the request payload. Trial mode configures trial-related texts and CTA shown in the Builder UI."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Trial sessions cannot be finalized with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /api/builder/sessions/{session_id}/contract/finalize"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTML support in trial fields:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"heading_text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": HTML supported (sanitized). Allowed tags: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"strong"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"b"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"wbr"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalize_content"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": HTML supported (sanitized). Allowed tags: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"strong"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"b"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"wbr"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"br"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"li"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ul"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"h2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"h3"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"h4"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"p"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"heading_cta_text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"preview_text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalize_title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalize_cta_text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": plain text only (HTML not supported)."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Finalization confirmation"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can optionally provide "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalization"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" settings to control the confirmation dialog shown before finalization. Omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalization"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to use the default dialog."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confirmation_enabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" controls whether confirmation dialog is shown before finalization."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confirmation_text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": HTML supported. Allowed tags: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"strong"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"b"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"wbr"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confirmation_enabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confirmation_text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the Builder UI falls back to its default confirmation message."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If trial mode is enabled ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"trial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalization"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" settings are ignored."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For more details and an example of the default dialog, see the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/legal-engine/finalize-confirmation"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Finalize confirmation dialog"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" guide."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Redirect URL"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"After creating a session, you'll get a one-time URL to send the end-user to our hosted builder UI. Opening the link creates a secure session with access to that document only."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The redirect URL is valid for 15 minutes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"builder/createbuildersession/request/handlers","deepLinkHash":"/builder/createbuildersession#builder/createbuildersession/request/handlers"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Handlers"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You need to provide handlers that redirect the end user back to your service after drafting."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Success handler"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user is redirected to this URL after completing the drafting session and filling in all the required information. The document is then considered \"ready\" and cannot be altered. Please note that the endpoint may be called multiple times if users navigates back to our builder via browser history."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cancel handler"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user is redirected to this URL after canceling the drafting session. The builder session remains intact. If the user navigates back to our UI using browser history, they can resume drafting. Therefore, it is possible for this handler to be called multiple times."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Delete handler"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user is redirected to this URL after the document is deleted. Document can be deleted via API and end-users can delete the document through the UI. Once deleted, the document cannot be altered, but it remains accessible via the API for a certain period before being permanently deleted. If the user navigates back to the builder after deletion, they will be automatically redirected to this handler. Consequently, this endpoint may be called multiple times."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error handler"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user is redirected to this URL when an unexpected error occurs."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"builder/createbuildersession/request/handler-url-parameters","deepLinkHash":"/builder/createbuildersession#builder/createbuildersession/request/handler-url-parameters"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Handler url parameters"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Handler URLs are appended (existing parameters will remain unchanged) with the following query parameters:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Parameter"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"session_id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Builder session ID"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"participant_id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Builder participant ID"},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1builder~1sessions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/CreateBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1builder~1sessions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/builder/sessions","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions/post/requestBody/content/application~1json/example"]}},"responseCodes":["201"],"pointer":"/api/builder/sessions","href":"builder/createbuildersession","openApiOperationId":"createBuilderSession","summary":"Create a new builder session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"schemaId":"components/schemas/CreateBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response with details about the builder session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14","exampleIds":["paths/~1api~1builder~1sessions/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_14","exampleIds":["paths/~1api~1builder~1sessions/post/responses/201/content/application~1json/example"]}],"pointer":"/paths/~1api~1builder~1sessions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_14","exampleIds":["paths/~1api~1builder~1sessions/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14","exampleIds":["paths/~1api~1builder~1sessions/post/responses/201/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/createbuildersession"}],"panels":[]}]},"httpPath":"/api/builder/sessions"},{"label":"Retrieve details of existing builder session","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/getbuildersession","routeSlug":"/embed-api/openapi/builder/getbuildersession","metadata":{"seo":{"title":"Retrieve details of existing builder session","description":"Returns details of the existing builder session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBuilderSession","name":"Retrieve details of existing builder session","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve details of existing builder session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns details of the existing builder session.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session to retrieve.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/builder/sessions/{session_id}","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/builder/sessions/{session_id}","href":"builder/getbuildersession","openApiOperationId":"getBuilderSession","summary":"Retrieve details of existing builder session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved the session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_15","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_15","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/get/responses/200/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_15","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_15","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/get/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/getbuildersession"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}"},{"label":"Update existing builder session","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/updatebuildersession","routeSlug":"/embed-api/openapi/builder/updatebuildersession","metadata":{"seo":{"title":"Update existing builder session","description":"Updates mutable builder session settings."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateBuilderSession","name":"Update existing builder session","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update existing builder session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates mutable builder session settings."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Currently the endpoint supports updating:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"trial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" mode configuration. Set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"trial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to disable trial mode."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalization"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" confirmation settings. Set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalization"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to clear custom finalization behavior."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For trial and finalization field definitions, constraints, and HTML support rules, see"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/createBuilderSession"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new builder session"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See also the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/legal-engine/finalize-confirmation"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Finalize confirmation dialog"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" guide."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session to update.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true},{"name":"X-Participant","in":"header","schemaId":"schema_16","description":"Participant ID of a user in this builder session.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PatchBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/PatchBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/api/builder/sessions/{session_id}","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"},{"name":"X-Participant","in":"header","required":true,"example":"123e4567-e89b-12d3-a456-426614174000","schemaId":"schema_16"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/PatchBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/requestBody/content/application~1json/example"]}},"responseCodes":["200","404","409","422"],"pointer":"/api/builder/sessions/{session_id}","href":"builder/updatebuildersession","openApiOperationId":"updateBuilderSession","summary":"Update existing builder session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"schemaId":"components/schemas/PatchBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/PatchBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully updated the session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_15","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/200/content/application~1json/example"]}},"schemaId":"schema_15","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/200/content/application~1json/example"]},{"code":"404","description":"Session or participant not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/404/content/application~1json/example"]},{"code":"409","description":"Session cannot be updated in its current state.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/409/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/409/content/application~1json/example"]},{"code":"422","description":"Validation error in request payload.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_15","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_15","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/404/content/application~1json/example"]}}},{"code":"409","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/409/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/patch/responses/409/content/application~1json/example"]}}},{"code":"422","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/updatebuildersession"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}"},{"label":"Delete builder session","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/deletebuildersession","routeSlug":"/embed-api/openapi/builder/deletebuildersession","metadata":{"seo":{"title":"Delete builder session","description":"Invalidates the builder session. The session is no longer accessible via the API after deletion. If the end user is still in the builder, they are redirected to the delete handler URL you provided when creating the session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteBuilderSession","name":"Delete builder session","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete builder session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Invalidates the builder session. The session is no longer accessible via the API after deletion. If the end user is still in the builder, they are redirected to the delete handler URL you provided when creating the session.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session to delete.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/builder/sessions/{session_id}","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/api/builder/sessions/{session_id}","href":"builder/deletebuildersession","openApiOperationId":"deleteBuilderSession","summary":"Delete builder session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"Successfully deleted the session. No content is returned."},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/deletebuildersession"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}"},{"label":"Get contract state and signees","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/getbuildersessioncontract","routeSlug":"/embed-api/openapi/builder/getbuildersessioncontract","metadata":{"seo":{"title":"Get contract state and signees","description":"Get contract's state and list of signees."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBuilderSessionContract","name":"Get contract state and signees","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get contract state and signees","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get contract's state and list of signees.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/builder/sessions/{session_id}/contract","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/builder/sessions/{session_id}/contract","href":"builder/getbuildersessioncontract","openApiOperationId":"getBuilderSessionContract","summary":"Get contract state and signees"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved contract","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContractState","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/ContractState","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/get/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContractState","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContractState","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/get/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/getbuildersessioncontract"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}/contract"},{"label":"Update contract state and appearance","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/patchbuildersessioncontract","routeSlug":"/embed-api/openapi/builder/patchbuildersessioncontract","metadata":{"seo":{"title":"Update contract state and appearance","description":"Update the contract's state values and appearance using JSON Patch (RFC 6902) operations.The available operations depend on the path, as does the value. Operations are applied sequentially in the order they appear, so later operations can build on the result of earlier ones."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"patchBuilderSessionContract","name":"Update contract state and appearance","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update contract state and appearance","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Update the contract's state values and appearance using "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://datatracker.ietf.org/doc/html/rfc6902"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON Patch (RFC 6902)"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operations."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The available operations depend on the path, as does the value. Operations are applied sequentially in the order they appear, so later operations can build on the result of earlier ones."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By default the patch is all-or-nothing: if any operation fails, nothing is saved and the endpoint returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"allow_partial: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to save the operations that succeed. The response is then always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and lists the failed operations under "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.failed_operations"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; if every operation failed, nothing is saved. A failed operation leaves no changes behind, so later operations that depend on it — including ones whose array index paths assume it succeeded — may fail or target a different element."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication, not-found, and malformed-request errors (such as an unsupported "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"op"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") fail the whole request. A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"5xx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response does not guarantee that nothing was saved, so read the state before retrying."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See more detailed description and examples "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/legal-engine/document-state"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Participant","in":"header","schemaId":"schema_16","description":"The participant ID for the builder session. This header is required for updating the contract state.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_17","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/allOrNothing","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/partial"]}},"schemaId":"schema_17","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/allOrNothing","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/partial"],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/api/builder/sessions/{session_id}/contract","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"X-Participant","in":"header","required":true,"example":"123e4567-e89b-12d3-a456-426614174000","schemaId":"schema_16"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_17","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/allOrNothing","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/partial"]}},"responseCodes":["200","401","404","422"],"pointer":"/api/builder/sessions/{session_id}/contract","href":"builder/patchbuildersessioncontract","openApiOperationId":"patchBuilderSessionContract","summary":"Update contract state and appearance"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"schemaId":"schema_17","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/allOrNothing","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/partial"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_17","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/allOrNothing","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/partial"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The resulting contract state. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.failed_operations"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" lists the operations that failed; an empty list means every operation was applied. Without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"allow_partial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" it is always empty, because any failed operation returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContractPatchResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialSomeFailed","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialAllFailed","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/fullState"]}},"schemaId":"components/schemas/ContractPatchResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialSomeFailed","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialAllFailed","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/fullState"]},{"code":"401","description":"Authentication failed. The API key is missing or invalid.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"},{"code":"404","description":"Session or participant not found, or the session has been deleted.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/404/content/application~1json/example"]},{"code":"422","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nothing was saved. Either the request is malformed, or — without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"allow_partial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — an operation failed. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.error.details"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" describes the problem when available."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/allOrNothingRejected","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/malformedRequest"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/allOrNothingRejected","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/malformedRequest"]}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContractPatchResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialSomeFailed","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialAllFailed","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/fullState"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContractPatchResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialSomeFailed","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialAllFailed","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/fullState"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/404/content/application~1json/example"]}}},{"code":"422","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/allOrNothingRejected","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/malformedRequest"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/allOrNothingRejected","paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/malformedRequest"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/patchbuildersessioncontract"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}/contract"},{"label":"Finalize contract","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/finalizebuildersessioncontract","routeSlug":"/embed-api/openapi/builder/finalizebuildersessioncontract","metadata":{"seo":{"title":"Finalize contract","description":"Finalize the current builder session contract. Once finalized, the document becomes read-only and can no longer be patched. The document PDF and HTML can still be downloaded."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"finalizeBuilderSessionContract","name":"Finalize contract","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Finalize contract","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Finalize the current builder session contract. Once finalized, the document becomes read-only and can no longer be patched. The document PDF and HTML can still be downloaded."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In most cases, the end-user finalizes the contract directly through the Builder UI. Use this endpoint when you need to trigger finalization programmatically from your backend."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Regardless of how finalization is triggered, if the end-user has the Builder UI open, they will be redirected to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success_handler"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" URL configured when creating the session."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session to finalize.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Participant","in":"header","schemaId":"schema_16","description":"The participant ID for the builder session performing the finalize action.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/builder/sessions/{session_id}/contract/finalize","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"X-Participant","in":"header","required":true,"example":"123e4567-e89b-12d3-a456-426614174000","schemaId":"schema_16"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","409"],"pointer":"/api/builder/sessions/{session_id}/contract/finalize","href":"builder/finalizebuildersessioncontract","openApiOperationId":"finalizeBuilderSessionContract","summary":"Finalize contract"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully finalized contract","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContractState"}},"schemaId":"components/schemas/ContractState"},{"code":"409","description":"Contract already finalized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_18","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post/responses/409/content/application~1json/example"]}},"schemaId":"schema_18","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post/responses/409/content/application~1json/example"]}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContractState","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContractState"}}},{"code":"409","schemaId":"schema_18","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post/responses/409/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_18","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post/responses/409/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/finalizebuildersessioncontract"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}/contract/finalize"},{"label":"Unfinalize contract","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/unfinalizebuildersessioncontract","routeSlug":"/embed-api/openapi/builder/unfinalizebuildersessioncontract","metadata":{"seo":{"title":"Unfinalize contract","description":"Revert a finalized builder session contract back to a pending (editable) state. Once unfinalized, the document can be patched again and the end-user can continue drafting."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"unfinalizeBuilderSessionContract","name":"Unfinalize contract","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Unfinalize contract","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Revert a finalized builder session contract back to a pending (editable) state. Once unfinalized, the document can be patched again and the end-user can continue drafting."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only a session with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status can be unfinalized. Calling this on a session that is not completed will return a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"409 Conflict"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" error."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session to unfinalize.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Participant","in":"header","schemaId":"schema_16","description":"The participant ID for the builder session performing the unfinalize action.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/builder/sessions/{session_id}/contract/unfinalize","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"X-Participant","in":"header","required":true,"example":"123e4567-e89b-12d3-a456-426614174000","schemaId":"schema_16"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","409"],"pointer":"/api/builder/sessions/{session_id}/contract/unfinalize","href":"builder/unfinalizebuildersessioncontract","openApiOperationId":"unfinalizeBuilderSessionContract","summary":"Unfinalize contract"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully unfinalized contract","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContractState"}},"schemaId":"components/schemas/ContractState"},{"code":"409","description":"Contract is not in a completed state.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_19","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post/responses/409/content/application~1json/example"]}},"schemaId":"schema_19","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post/responses/409/content/application~1json/example"]}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContractState","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContractState"}}},{"code":"409","schemaId":"schema_19","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post/responses/409/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_19","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post/responses/409/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/unfinalizebuildersessioncontract"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}/contract/unfinalize"},{"label":"Get HTML","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/getbuildersessionhtml","routeSlug":"/embed-api/openapi/builder/getbuildersessionhtml","metadata":{"seo":{"title":"Get HTML","description":"Retrieve the rendered HTML of the builder session document. This matches the PDF contents but in HTML format for previewing or custom rendering flows."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBuilderSessionHtml","name":"Get HTML","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1html/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get HTML","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve the rendered HTML of the builder session document. This matches the PDF contents but in HTML format for previewing or custom rendering flows.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1html/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/builder/sessions/{session_id}/html","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/api/builder/sessions/{session_id}/html","href":"builder/getbuildersessionhtml","openApiOperationId":"getBuilderSessionHtml","summary":"Get HTML"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved HTML","mediaType":"text/html","mediaTypes":["text/html"],"mediaTypeContent":{"text/html":{"schemaId":"schema_7"}},"schemaId":"schema_7"},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1html/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1html/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1html/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_7","mediaTypes":["text/html"],"mediaTypeContent":{"text/html":{"schemaId":"schema_7"}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1html/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1html/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/getbuildersessionhtml"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}/html"},{"label":"Get PDF","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/getbuildersessionpdf","routeSlug":"/embed-api/openapi/builder/getbuildersessionpdf","metadata":{"seo":{"title":"Get PDF","description":"Get rendered PDF for the builder session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBuilderSessionPdf","name":"Get PDF","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1pdf/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get PDF","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get rendered PDF for the builder session.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1pdf/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/builder/sessions/{session_id}/pdf","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"pointer":"/api/builder/sessions/{session_id}/pdf","href":"builder/getbuildersessionpdf","openApiOperationId":"getBuilderSessionPdf","summary":"Get PDF"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/getbuildersessionpdf"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}/pdf"},{"label":"Add new participant to existing session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/addparticipanttobuildersession","routeSlug":"/embed-api/openapi/builder/addparticipanttobuildersession","metadata":{"seo":{"title":"Add new participant to existing session","description":"Add a new participant to an existing Builder session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addParticipantToBuilderSession","name":"Add new participant to existing session","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add new participant to existing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Add a new participant to an existing Builder session.\n\nThis is useful for collaboration flows where multiple users can access and draft\nthe same document session.\n\nThe response includes a one-time URL that authenticates the added participant into\nthe existing session. After creating the participant, redirect that user to the\nreturned URL.\n\nThe Builder handles real-time collaboration automatically. All participants stay in\nsync without manual page refreshes.\n\nIf any participant finalizes the document, all active participants are redirected to\nthe success handler that was configured when the session was created.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/AddParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/builder/sessions/{session_id}/participants","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AddParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","404","422"],"pointer":"/api/builder/sessions/{session_id}/participants","href":"builder/addparticipanttobuildersession","openApiOperationId":"addParticipantToBuilderSession","summary":"Add new participant to existing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"schemaId":"components/schemas/AddParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AddParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response with details about the added participant.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_20","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_20","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"]},{"code":"422","description":"Validation error in request payload.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_20","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_20","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"]}}},{"code":"422","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/addparticipanttobuildersession"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}/participants"},{"label":"Re-authenticate existing participant","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/reauthenticateparticipant","routeSlug":"/embed-api/openapi/builder/reauthenticateparticipant","metadata":{"seo":{"title":"Re-authenticate existing participant","description":"If you want to re-authenticate an existing participant in an ongoing Builder session, you can use this endpoint."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"reauthenticateParticipant","name":"Re-authenticate existing participant","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Re-authenticate existing participant","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you want to re-authenticate an existing participant in an ongoing Builder session, you can use this endpoint."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See details about the url in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/createBuilderSession"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"create builder session"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session.","required":true},{"name":"participant_id","in":"path","schemaId":"schema_16","description":"The UUID of the participant to authenticate.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/builder/sessions/{session_id}/participants/{participant_id}/authenticate","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"},{"name":"participant_id","in":"path","required":true,"example":"123e4567-e89b-12d3-a456-426614174000","schemaId":"schema_16"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/requestBody/content/application~1json/example"]}},"responseCodes":["201"],"pointer":"/api/builder/sessions/{session_id}/participants/{participant_id}/authenticate","href":"builder/reauthenticateparticipant","openApiOperationId":"reauthenticateParticipant","summary":"Re-authenticate existing participant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response with details about the authenticated participant.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_20","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_20","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/responses/201/content/application~1json/example"]}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_20","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_20","exampleIds":["paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/responses/201/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/reauthenticateparticipant"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}/participants/{participant_id}/authenticate"},{"label":"Export builder session","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/exportbuildersession","routeSlug":"/embed-api/openapi/builder/exportbuildersession","metadata":{"seo":{"title":"Export builder session","description":"Export a builder session as a ZIP file so you can save it and later create a new draftwith import."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"exportBuilderSession","name":"Export builder session","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1export/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Export builder session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Export a builder session as a ZIP file so you can save it and later create a new draft"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/importBuilderSession"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"import"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this when implementing document duplication (for example, after a document is finalized"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and you want to start a similar new document)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ZIP contains session drafting data, including all attachments, values filled to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contract, and style customizations. It does not include integration redirect handlers"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"handlers"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_10","description":"The UUID of the session to export.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1export/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Participant","in":"header","schemaId":"schema_16","description":"The participant ID for the builder session export request.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1export/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/builder/sessions/{session_id}/export","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","schemaId":"schema_10"}],"query":[],"querystring":[],"header":[{"name":"X-Participant","in":"header","required":true,"example":"123e4567-e89b-12d3-a456-426614174000","schemaId":"schema_16"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/api/builder/sessions/{session_id}/export","href":"builder/exportbuildersession","openApiOperationId":"exportBuilderSession","summary":"Export builder session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully exported builder session as ZIP archive.","mediaType":"application/zip","mediaTypes":["application/zip"],"mediaTypeContent":{"application/zip":{"schemaId":"components/schemas/BuilderSessionExportFile"}},"schemaId":"components/schemas/BuilderSessionExportFile"}],"pointer":"/paths/~1api~1builder~1sessions~1{session_id}~1export/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BuilderSessionExportFile","mediaTypes":["application/zip"],"mediaTypeContent":{"application/zip":{"schemaId":"components/schemas/BuilderSessionExportFile"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/exportbuildersession"}],"panels":[]}]},"httpPath":"/api/builder/sessions/{session_id}/export"},{"label":"Import builder session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/builder/importbuildersession","routeSlug":"/embed-api/openapi/builder/importbuildersession","metadata":{"seo":{"title":"Import builder session","description":"Import a previously exported builder session ZIP archive and create a new builder session from it."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"importBuilderSession","name":"Import builder session","isWebhook":false,"pointer":"/paths/~1api~1builder~1sessions~1import/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Import builder session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Import a previously exported builder session ZIP archive and create a new builder session from it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The exported bundle is signed. No changes to the bundle contents are allowed before import."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the bundle is modified in any way, import fails with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request must include:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"session_file"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": a ZIP file created by the export endpoint (max size 15 MB)."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"handlers"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": redirect handlers for the new imported session."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For details about handlers, participant fields, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ui_language"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", see the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/createBuilderSession"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new builder session"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1api~1builder~1sessions~1import/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"components/schemas/ImportBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1import/post/requestBody/content/multipart~1form-data/example"]}},"schemaId":"components/schemas/ImportBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1import/post/requestBody/content/multipart~1form-data/example"],"pointer":"/paths/~1api~1builder~1sessions~1import/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/builder/sessions/import","servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"components/schemas/ImportBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1import/post/requestBody/content/multipart~1form-data/example"]}},"responseCodes":["201","400"],"pointer":"/api/builder/sessions/import","href":"builder/importbuildersession","openApiOperationId":"importBuilderSession","summary":"Import builder session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.builder.docue.com","description":"Production (Legal Engine)"}],"schemaId":"components/schemas/ImportBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1import/post/requestBody/content/multipart~1form-data/example"],"mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"components/schemas/ImportBuilderSessionPayload","exampleIds":["paths/~1api~1builder~1sessions~1import/post/requestBody/content/multipart~1form-data/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response with details about the imported builder session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BuilderSessionImportResponse","exampleIds":["paths/~1api~1builder~1sessions~1import/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/BuilderSessionImportResponse","exampleIds":["paths/~1api~1builder~1sessions~1import/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Session import failed. This can happen if the exported bundle was modified.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1import/post/responses/400/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1import/post/responses/400/content/application~1json/example"]}],"pointer":"/paths/~1api~1builder~1sessions~1import/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/BuilderSessionImportResponse","exampleIds":["paths/~1api~1builder~1sessions~1import/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BuilderSessionImportResponse","exampleIds":["paths/~1api~1builder~1sessions~1import/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1import/post/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1api~1builder~1sessions~1import/post/responses/400/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/builder/importbuildersession"}],"panels":[]}]},"httpPath":"/api/builder/sessions/import"}],"content":{"contentType":"group","meta":{"name":"Builder"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Builder","showPageActions":true},{"nodeType":"markdoc","content":"Hosted UI for end users to draft their document."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/builder/sessions","summary":"Create a new builder session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/builder/createbuildersession","deprecated":false},{"title":"/api/builder/sessions/{session_id}","summary":"Retrieve details of existing builder session","prefix":{"name":"get","color":"get"},"badges":[],"link":"/builder/getbuildersession","deprecated":false},{"title":"/api/builder/sessions/{session_id}","summary":"Update existing builder session","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/builder/updatebuildersession","deprecated":false},{"title":"/api/builder/sessions/{session_id}","summary":"Delete builder session","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/builder/deletebuildersession","deprecated":false},{"title":"/api/builder/sessions/{session_id}/contract","summary":"Get contract state and signees","prefix":{"name":"get","color":"get"},"badges":[],"link":"/builder/getbuildersessioncontract","deprecated":false},{"title":"/api/builder/sessions/{session_id}/contract","summary":"Update contract state and appearance","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/builder/patchbuildersessioncontract","deprecated":false},{"title":"/api/builder/sessions/{session_id}/contract/finalize","summary":"Finalize contract","prefix":{"name":"post","color":"post"},"badges":[],"link":"/builder/finalizebuildersessioncontract","deprecated":false},{"title":"/api/builder/sessions/{session_id}/contract/unfinalize","summary":"Unfinalize contract","prefix":{"name":"post","color":"post"},"badges":[],"link":"/builder/unfinalizebuildersessioncontract","deprecated":false},{"title":"/api/builder/sessions/{session_id}/html","summary":"Get HTML","prefix":{"name":"get","color":"get"},"badges":[],"link":"/builder/getbuildersessionhtml","deprecated":false},{"title":"/api/builder/sessions/{session_id}/pdf","summary":"Get PDF","prefix":{"name":"get","color":"get"},"badges":[],"link":"/builder/getbuildersessionpdf","deprecated":false},{"title":"/api/builder/sessions/{session_id}/participants","summary":"Add new participant to existing session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/builder/addparticipanttobuildersession","deprecated":false},{"title":"/api/builder/sessions/{session_id}/participants/{participant_id}/authenticate","summary":"Re-authenticate existing participant","prefix":{"name":"post","color":"post"},"badges":[],"link":"/builder/reauthenticateparticipant","deprecated":false},{"title":"/api/builder/sessions/{session_id}/export","summary":"Export builder session","prefix":{"name":"get","color":"get"},"badges":[],"link":"/builder/exportbuildersession","deprecated":false},{"title":"/api/builder/sessions/import","summary":"Import builder session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/builder/importbuildersession","deprecated":false}]}]}]}]}},{"type":"group","label":"Signing","link":"/embed-api/openapi/signing","routeSlug":"/embed-api/openapi/signing","items":[{"label":"Create a signing session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/createsigningsession","routeSlug":"/embed-api/openapi/signing/createsigningsession","metadata":{"seo":{"title":"Create a signing session","description":"Create a signing session by providing files and participants."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSigningSession","name":"Create a signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a signing session by providing files and participants."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Include signers in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"participants"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array here, or add them later while the session is in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" state."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Files can be provided either by URL or uploaded directly:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON request"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): provide files as URL references in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"files"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multipart request"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): upload file content directly as binary parts. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" part contains the JSON payload, and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"files"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parts contain the binary file content. Each uploaded file corresponds by position to an entry in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.files"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that does not have a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json","multipart/form-data"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSigningSessionPayload","exampleIds":["paths/~1sign~1sessions/post/requestBody/content/application~1json/example"]},"multipart/form-data":{"schemaId":"schema_21","exampleIds":["paths/~1sign~1sessions/post/requestBody/content/multipart~1form-data/example"]}},"schemaId":"components/schemas/CreateSigningSessionPayload","exampleIds":["paths/~1sign~1sessions/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1sign~1sessions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateSigningSessionPayload","exampleIds":["paths/~1sign~1sessions/post/requestBody/content/application~1json/example"]},"multipart/form-data":{"schemaId":"schema_21","exampleIds":["paths/~1sign~1sessions/post/requestBody/content/multipart~1form-data/example"]}},"responseCodes":["201","422"],"pointer":"/sign/sessions","href":"signing/createsigningsession","openApiOperationId":"createSigningSession","summary":"Create a signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"schemaId":"components/schemas/CreateSigningSessionPayload","exampleIds":["paths/~1sign~1sessions/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json","multipart/form-data"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSigningSessionPayload","exampleIds":["paths/~1sign~1sessions/post/requestBody/content/application~1json/example"]},"multipart/form-data":{"schemaId":"schema_21","exampleIds":["paths/~1sign~1sessions/post/requestBody/content/multipart~1form-data/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successful response with details about the signing session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions/post/responses/201/content/application~1json/example"]},{"code":"422","description":"Signing session participant limit exceeded.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1sign~1sessions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions/post/responses/201/content/application~1json/example"]}}},{"code":"422","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/createsigningsession"}],"panels":[]}]},"httpPath":"/sign/sessions"},{"label":"Retrieve details of existing signing session","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/getsigningsession","routeSlug":"/embed-api/openapi/signing/getsigningsession","metadata":{"seo":{"title":"Retrieve details of existing signing session","description":"Returns details of the existing signing session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSigningSession","name":"Retrieve details of existing signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve details of existing signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns details of the existing signing session.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/sign/sessions/{session_id}","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/sign/sessions/{session_id}","href":"signing/getsigningsession","openApiOperationId":"getSigningSession","summary":"Retrieve details of existing signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved the signing session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}/get/responses/200/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}/get/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/getsigningsession"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}"},{"label":"End signing session","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/endsigningsession","routeSlug":"/embed-api/openapi/signing/endsigningsession","metadata":{"seo":{"title":"End signing session","description":"End an existing signing session. A pending session is discarded and can no longer be used. A started session is cancelled. Participants who were invited are notified and can still view the document."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"endSigningSession","name":"End signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"End signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"End an existing signing session.\nA pending session is discarded and can no longer be used.\nA started session is cancelled. Participants who were invited are notified and can still view the document.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/sign/sessions/{session_id}","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404","409"],"pointer":"/sign/sessions/{session_id}","href":"signing/endsigningsession","openApiOperationId":"endSigningSession","summary":"End signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully ended the signing session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse"}},"schemaId":"components/schemas/SigningSessionResponse"},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"},{"code":"409","description":"Signing session cannot be ended in its current state.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1sign~1sessions~1{session_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SigningSessionResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse"}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}},{"code":"409","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/endsigningsession"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}"},{"label":"Start signing session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/startsigningsession","routeSlug":"/embed-api/openapi/signing/startsigningsession","metadata":{"seo":{"title":"Start signing session","description":"Start an existing signing session.This moves the session status from pending to started.Starting a session locks its files (no files can be added or removed) and allows participants to access the signing flow via their links.Queued invitations are sent when the session starts.If the session is not in pending state, the endpoint returns 409 Conflict."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"startSigningSession","name":"Start signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1start/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Start signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Start an existing signing session."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This moves the session status from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"started"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Starting a session locks its files (no files can be added or removed) and allows participants to access the signing flow via their links."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Queued invitations are sent when the session starts."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the session is not in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" state, the endpoint returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"409 Conflict"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1start/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1start/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/start","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404","409"],"pointer":"/sign/sessions/{session_id}/start","href":"signing/startsigningsession","openApiOperationId":"startSigningSession","summary":"Start signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully started the signing session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/200/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/404/content/application~1json/example"]},{"code":"409","description":"Signing session is not pending.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/409/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/409/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1start/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/404/content/application~1json/example"]}}},{"code":"409","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/409/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1start/post/responses/409/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/startsigningsession"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/start"},{"label":"Renew expired signing session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/renewsigningsession","routeSlug":"/embed-api/openapi/signing/renewsigningsession","metadata":{"seo":{"title":"Renew expired signing session","description":"Renew an expired signing session with a new due date. A session that expired after it was started returns to started, signatures already collected are kept. A session that expired before it was started returns to pending."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"renewSigningSession","name":"Renew expired signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1renew/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Renew expired signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Renew an expired signing session with a new due date.\nA session that expired after it was started returns to started, signatures already collected are kept. \nA session that expired before it was started returns to pending.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1renew/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1renew/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_23"}},"schemaId":"schema_23","pointer":"/paths/~1sign~1sessions~1{session_id}~1renew/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/renew","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_23"}},"responseCodes":["200","404","409"],"pointer":"/sign/sessions/{session_id}/renew","href":"signing/renewsigningsession","openApiOperationId":"renewSigningSession","summary":"Renew expired signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"schemaId":"schema_23","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_23"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully renewed the signing session.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse"}},"schemaId":"components/schemas/SigningSessionResponse"},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"},{"code":"409","description":"Signing session is not expired.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1renew/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SigningSessionResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionResponse"}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}},{"code":"409","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/renewsigningsession"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/renew"},{"label":"Get signing session PDF","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/getsigningsessionpdf","routeSlug":"/embed-api/openapi/signing/getsigningsessionpdf","metadata":{"seo":{"title":"Get signing session PDF","description":"Get the PDF for the signing session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSigningSessionPdf","name":"Get signing session PDF","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1pdf/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get signing session PDF","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get the PDF for the signing session."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Download the final document once the session status is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"After the last signature, the audit log and required signing evidence"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are packaged into the PDF. A download made before the session is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"completed contains the cryptographically valid signatures applied so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"far, but not that evidence package."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the session contains multiple files, they are merged and returned as one PDF."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/signing/signed-document"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieving the signed document"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1pdf/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/sign/sessions/{session_id}/pdf","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/sign/sessions/{session_id}/pdf","href":"signing/getsigningsessionpdf","openApiOperationId":"getSigningSessionPdf","summary":"Get signing session PDF"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved the signing session PDF.","mediaType":"application/pdf","mediaTypes":["application/pdf"],"mediaTypeContent":{"application/pdf":{"schemaId":"schema_24"}},"schemaId":"schema_24"},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1pdf/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1pdf/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1pdf/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_24","mediaTypes":["application/pdf"],"mediaTypeContent":{"application/pdf":{"schemaId":"schema_24"}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1pdf/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1pdf/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/getsigningsessionpdf"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/pdf"},{"label":"List recent webhook delivery attempts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/listsigningsessionwebhookcalls","routeSlug":"/embed-api/openapi/signing/listsigningsessionwebhookcalls","metadata":{"seo":{"title":"List recent webhook delivery attempts","description":"Returns the most recent webhook delivery attempts for the signingsession, newest first. Up to 50 attempts are returned."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listSigningSessionWebhookCalls","name":"List recent webhook delivery attempts","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1webhooks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List recent webhook delivery attempts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the most recent webhook delivery attempts for the signing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"session, newest first. Up to 50 attempts are returned."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/signing/webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Signing webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for delivery"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"behavior, event types, and signature validation."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1webhooks/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1webhooks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/sign/sessions/{session_id}/webhooks","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/sign/sessions/{session_id}/webhooks","href":"signing/listsigningsessionwebhookcalls","openApiOperationId":"listSigningSessionWebhookCalls","summary":"List recent webhook delivery attempts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved the webhook delivery attempts.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_25","exampleIds":["paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_25","exampleIds":["paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/200/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_25","exampleIds":["paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_25","exampleIds":["paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/listsigningsessionwebhookcalls"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/webhooks"},{"label":"List audit records for a signing session","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/listsigningsessionauditrecords","routeSlug":"/embed-api/openapi/signing/listsigningsessionauditrecords","metadata":{"seo":{"title":"List audit records for a signing session","description":"Returns the audit records for the signing session, oldest first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listSigningSessionAuditRecords","name":"List audit records for a signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1audit/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List audit records for a signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the audit records for the signing session, oldest first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1audit/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page[size]","in":"query","schemaId":"schema_26","description":"How many records to return. Defaults to 100."},{"name":"page[pointer]","in":"query","schemaId":"schema_7","description":"Cursor from a previous page. Leave it out to start at the oldest records."}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1audit/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1audit/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/sign/sessions/{session_id}/audit","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[{"name":"page[size]","in":"query","required":false,"schemaId":"schema_26"},{"name":"page[pointer]","in":"query","required":false,"schemaId":"schema_7"}],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/sign/sessions/{session_id}/audit","href":"signing/listsigningsessionauditrecords","openApiOperationId":"listSigningSessionAuditRecords","summary":"List audit records for a signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved the audit records.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_27","exampleIds":["paths/~1sign~1sessions~1{session_id}~1audit/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_27","exampleIds":["paths/~1sign~1sessions~1{session_id}~1audit/get/responses/200/content/application~1json/example"]},{"code":"404","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1audit/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_27","exampleIds":["paths/~1sign~1sessions~1{session_id}~1audit/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_27","exampleIds":["paths/~1sign~1sessions~1{session_id}~1audit/get/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/listsigningsessionauditrecords"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/audit"},{"label":"Add new file to signing session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/createsigningsessionfile","routeSlug":"/embed-api/openapi/signing/createsigningsessionfile","metadata":{"seo":{"title":"Add new file to signing session","description":"Add a new file to an existing signing session.If index is provided, the file is inserted at that zero-based position in the files array.If index is omitted, the file is appended to the end of the files array.If the signing session is in state started, no new files can be added and the endpoint returns 409 Conflict."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSigningSessionFile","name":"Add new file to signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1files/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add new file to signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add a new file to an existing signing session."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"index"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, the file is inserted at that zero-based position in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"files"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"index"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is omitted, the file is appended to the end of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"files"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the signing session is in state "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"started"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", no new files can be added and the endpoint returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"409 Conflict"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The file can be provided either by URL or uploaded directly:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON request"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): provide the file as a URL reference."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multipart request"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): upload the file content directly as a binary part."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1files/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1files/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json","multipart/form-data"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SigningSessionFileCreatePayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/application~1json/example"]},"multipart/form-data":{"schemaId":"schema_28","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/multipart~1form-data/example"]}},"schemaId":"components/schemas/SigningSessionFileCreatePayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1sign~1sessions~1{session_id}~1files/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/files","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/SigningSessionFileCreatePayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/application~1json/example"]},"multipart/form-data":{"schemaId":"schema_28","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/multipart~1form-data/example"]}},"responseCodes":["201","404","409"],"pointer":"/sign/sessions/{session_id}/files","href":"signing/createsigningsessionfile","openApiOperationId":"createSigningSessionFile","summary":"Add new file to signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"schemaId":"components/schemas/SigningSessionFileCreatePayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json","multipart/form-data"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SigningSessionFileCreatePayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/application~1json/example"]},"multipart/form-data":{"schemaId":"schema_28","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/multipart~1form-data/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successfully created the file.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionFileResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/SigningSessionFileResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/201/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/404/content/application~1json/example"]},{"code":"409","description":"Signing session is already started.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/409/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/409/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1files/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/SigningSessionFileResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionFileResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/201/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/404/content/application~1json/example"]}}},{"code":"409","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/409/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1files/post/responses/409/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/createsigningsessionfile"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/files"},{"label":"Add new participant to signing session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/createsigningsessionparticipant","routeSlug":"/embed-api/openapi/signing/createsigningsessionparticipant","metadata":{"seo":{"title":"Add new participant to signing session","description":"Add a new participant to an existing signing session. The session must be in pending state."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSigningSessionParticipant","name":"Add new participant to signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add new participant to signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add a new participant to an existing signing session. The session must be in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" state."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipant","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/SigningSessionParticipant","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/participants","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipant","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","404","422"],"pointer":"/sign/sessions/{session_id}/participants","href":"signing/createsigningsessionparticipant","openApiOperationId":"createSigningSessionParticipant","summary":"Add new participant to signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"schemaId":"components/schemas/SigningSessionParticipant","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipant","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successfully created the participant.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/SigningSessionParticipantResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"]},{"code":"422","description":"Signing session participant limit exceeded.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/SigningSessionParticipantResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"]}}},{"code":"422","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/createsigningsessionparticipant"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/participants"},{"label":"Remove participant from signing session","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/removesigningsessionparticipant","routeSlug":"/embed-api/openapi/signing/removesigningsessionparticipant","metadata":{"seo":{"title":"Remove participant from signing session","description":"Remove an existing participant from the signing session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"removeSigningSessionParticipant","name":"Remove participant from signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove participant from signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Remove an existing participant from the signing session.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true},{"name":"participant_id","in":"path","schemaId":"schema_29","description":"The UUID of the participant.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/sign/sessions/{session_id}/participants/{participant_id}","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"},{"name":"participant_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","schemaId":"schema_29"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/sign/sessions/{session_id}/participants/{participant_id}","href":"signing/removesigningsessionparticipant","openApiOperationId":"removeSigningSessionParticipant","summary":"Remove participant from signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"Successfully removed the participant. No content is returned."},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/removesigningsessionparticipant"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/participants/{participant_id}"},{"label":"Excuse participant from signing on started session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/excusesigningsessionparticipant","routeSlug":"/embed-api/openapi/signing/excusesigningsessionparticipant","metadata":{"seo":{"title":"Excuse participant from signing on started session","description":"Release a participant from the requirement to sign. Their outstanding invitations stop working immediately."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"excuseSigningSessionParticipant","name":"Excuse participant from signing on started session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1excuse/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Excuse participant from signing on started session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Release a participant from the requirement to sign. Their outstanding\ninvitations stop working immediately.\n\nAt least one participant must still sign or have signed.\nYou cannot excuse a participant who is currently signing or who has already signed.\n\nIf nobody remains who still needs to sign, the session completes.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true},{"name":"participant_id","in":"path","schemaId":"schema_29","description":"The UUID of the participant.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1excuse/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1excuse/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/participants/{participant_id}/excuse","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"},{"name":"participant_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","schemaId":"schema_29"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404","409","422"],"pointer":"/sign/sessions/{session_id}/participants/{participant_id}/excuse","href":"signing/excusesigningsessionparticipant","openApiOperationId":"excuseSigningSessionParticipant","summary":"Excuse participant from signing on started session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully excused the participant.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantResponse"}},"schemaId":"components/schemas/SigningSessionParticipantResponse"},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"},{"code":"409","description":"Signing session is not started, or the participant cannot be excused.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"},{"code":"422","description":"At least one participant must still sign or have signed.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1excuse/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SigningSessionParticipantResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantResponse"}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}},{"code":"409","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/excusesigningsessionparticipant"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/participants/{participant_id}/excuse"},{"label":"Reinstate a declined participant","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/reinstatesigningsessionparticipant","routeSlug":"/embed-api/openapi/signing/reinstatesigningsessionparticipant","metadata":{"seo":{"title":"Reinstate a declined participant","description":"Bring a declined participant back to pending. No invitation is sent."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"reinstateSigningSessionParticipant","name":"Reinstate a declined participant","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1reinstate/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reinstate a declined participant","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Bring a declined participant back to pending. No invitation is sent.\n\nThe session must be started. Only a declined participant can be\nreinstated.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true},{"name":"participant_id","in":"path","schemaId":"schema_29","description":"The UUID of the participant.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1reinstate/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1reinstate/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/participants/{participant_id}/reinstate","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"},{"name":"participant_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","schemaId":"schema_29"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404","409"],"pointer":"/sign/sessions/{session_id}/participants/{participant_id}/reinstate","href":"signing/reinstatesigningsessionparticipant","openApiOperationId":"reinstateSigningSessionParticipant","summary":"Reinstate a declined participant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully reinstated the participant.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantResponse"}},"schemaId":"components/schemas/SigningSessionParticipantResponse"},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"},{"code":"409","description":"Signing session is not started, or the participant has not declined.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1reinstate/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SigningSessionParticipantResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantResponse"}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}},{"code":"409","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/reinstatesigningsessionparticipant"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/participants/{participant_id}/reinstate"},{"label":"Create invitation for participant","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/createsigningsessionparticipantinvitation","routeSlug":"/embed-api/openapi/signing/createsigningsessionparticipantinvitation","metadata":{"seo":{"title":"Create invitation for participant","description":"Creates a new invitation for a participant."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSigningSessionParticipantInvitation","name":"Create invitation for participant","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create invitation for participant","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new invitation for a participant.\n\nFor manual delivery, the response includes a signing URL that you share\nwith the signer. Allowed while the session is pending or started.\n\nFor email or SMS delivery, Docue notifies the signer and no signing URL\nis returned. The session must already be started.\n\nManual signing URLs work only after the session has started.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true},{"name":"participant_id","in":"path","schemaId":"schema_29","description":"The UUID of the participant.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantInvitationCreate","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/email","paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/manual"]}},"schemaId":"components/schemas/SigningSessionParticipantInvitationCreate","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/email","paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/manual"],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/participants/{participant_id}/invitations","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"},{"name":"participant_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","schemaId":"schema_29"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantInvitationCreate","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/email","paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/manual"]}},"responseCodes":["201","404"],"pointer":"/sign/sessions/{session_id}/participants/{participant_id}/invitations","href":"signing/createsigningsessionparticipantinvitation","openApiOperationId":"createSigningSessionParticipantInvitation","summary":"Create invitation for participant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"schemaId":"components/schemas/SigningSessionParticipantInvitationCreate","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/email","paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/manual"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantInvitationCreate","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/email","paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/manual"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successfully created the invitation.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantInvitationResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/email","paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/manual"]}},"schemaId":"components/schemas/SigningSessionParticipantInvitationResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/email","paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/manual"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/SigningSessionParticipantInvitationResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/email","paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/manual"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionParticipantInvitationResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/email","paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/manual"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/createsigningsessionparticipantinvitation"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/participants/{participant_id}/invitations"},{"label":"Resend an invitation","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/resendsigningsessionparticipantinvitation","routeSlug":"/embed-api/openapi/signing/resendsigningsessionparticipantinvitation","metadata":{"seo":{"title":"Resend an invitation","description":"Sends the same email or SMS again for an invitation that was already sent.The signing URL does not change and no new invitation is created."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"resendSigningSessionParticipantInvitation","name":"Resend an invitation","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}~1resend/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Resend an invitation","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sends the same email or SMS again for an invitation that was already sent."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The signing URL does not change and no new invitation is created."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/signing/invitations#resend-an-invitation"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invitations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for when"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resending is allowed and how often you can do it."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true},{"name":"participant_id","in":"path","schemaId":"schema_29","description":"The UUID of the participant.","required":true},{"name":"invitation_id","in":"path","schemaId":"schema_30","description":"The UUID of the invitation.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}~1resend/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}~1resend/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/participants/{participant_id}/invitations/{invitation_id}/resend","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"},{"name":"participant_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","schemaId":"schema_29"},{"name":"invitation_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88311","schemaId":"schema_30"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["204","404","422","429"],"pointer":"/sign/sessions/{session_id}/participants/{participant_id}/invitations/{invitation_id}/resend","href":"signing/resendsigningsessionparticipantinvitation","openApiOperationId":"resendSigningSessionParticipantInvitation","summary":"Resend an invitation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The invitation will be sent again. No content is returned."},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"},{"code":"422","description":"The invitation cannot be resent in its current state.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"},{"code":"429","description":"The invitation was resent too recently.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}},"schemaId":"components/schemas/ErrorResponse"}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}~1resend/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"404","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}},{"code":"422","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}},{"code":"429","schemaId":"components/schemas/ErrorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/resendsigningsessionparticipantinvitation"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/participants/{participant_id}/invitations/{invitation_id}/resend"},{"label":"Revoke a previously created invitation","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/deletesigningsessionparticipantinvitation","routeSlug":"/embed-api/openapi/signing/deletesigningsessionparticipantinvitation","metadata":{"seo":{"title":"Revoke a previously created invitation","description":"Revoke a single invitation so its signing URL stops working immediately."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteSigningSessionParticipantInvitation","name":"Revoke a previously created invitation","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Revoke a previously created invitation","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Revoke a single invitation so its signing URL stops working immediately.\n\nEach invitation has its own signing URL; revoking one invitation does not affect\nother invitations for the same participant. Use this when a message was sent to\nthe wrong recipient or the link must otherwise be invalidated.\n\nRevoking an already-revoked invitation returns 409 Conflict.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true},{"name":"participant_id","in":"path","schemaId":"schema_29","description":"The UUID of the participant.","required":true},{"name":"invitation_id","in":"path","schemaId":"schema_30","description":"The UUID of the invitation.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/sign/sessions/{session_id}/participants/{participant_id}/invitations/{invitation_id}","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"},{"name":"participant_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","schemaId":"schema_29"},{"name":"invitation_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88311","schemaId":"schema_30"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["204","404","409"],"pointer":"/sign/sessions/{session_id}/participants/{participant_id}/invitations/{invitation_id}","href":"signing/deletesigningsessionparticipantinvitation","openApiOperationId":"deleteSigningSessionParticipantInvitation","summary":"Revoke a previously created invitation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"Successfully revoked the invitation. No content is returned."},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/404/content/application~1json/example"]},{"code":"409","description":"Invitation already revoked.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/409/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/409/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/404/content/application~1json/example"]}}},{"code":"409","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/409/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/409/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/deletesigningsessionparticipantinvitation"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/participants/{participant_id}/invitations/{invitation_id}"},{"label":"Create sender UI for signing session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/createsigningsessionsenderui","routeSlug":"/embed-api/openapi/signing/createsigningsessionsenderui","metadata":{"seo":{"title":"Create sender UI for signing session","description":"Create a new Sender UI resource for an existing signing session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSigningSessionSenderUi","name":"Create sender UI for signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create sender UI for signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new Sender UI resource for an existing signing session."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response includes a one-time URL to the hosted Sender UI."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL is valid for 15 minutes and becomes invalid immediately after first successful use."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You must provide a handler URL:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"return_handler"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": the user is redirected to this URL when leaving the Sender UI."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The handler URL is appended with query parameters:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Parameter"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"session_id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Signing session ID"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sender_ui_id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sender UI ID"},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint when you want to create a new Sender UI instance with its own handlers and configuration."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSigningSessionSenderUiPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/CreateSigningSessionSenderUiPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/sender-uis","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateSigningSessionSenderUiPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","404"],"pointer":"/sign/sessions/{session_id}/sender-uis","href":"signing/createsigningsessionsenderui","openApiOperationId":"createSigningSessionSenderUi","summary":"Create sender UI for signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"schemaId":"components/schemas/CreateSigningSessionSenderUiPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSigningSessionSenderUiPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successfully created and authenticated sender UI.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionSenderUiAuthenticatedResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/SigningSessionSenderUiAuthenticatedResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/201/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/SigningSessionSenderUiAuthenticatedResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionSenderUiAuthenticatedResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/201/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/createsigningsessionsenderui"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/sender-uis"},{"label":"List sender interfaces for signing session","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/getsigningsessionsenderuis","routeSlug":"/embed-api/openapi/signing/getsigningsessionsenderuis","metadata":{"seo":{"title":"List sender interfaces for signing session","description":"List existing Sender UI resources for the signing session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSigningSessionSenderUis","name":"List sender interfaces for signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List sender interfaces for signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List existing Sender UI resources for the signing session.\n\nThe list response does not include one-time authentication URLs.\nTo open an existing Sender UI again, call the authenticate endpoint.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/sign/sessions/{session_id}/sender-uis","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/sign/sessions/{session_id}/sender-uis","href":"signing/getsigningsessionsenderuis","openApiOperationId":"getSigningSessionSenderUis","summary":"List sender interfaces for signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully retrieved sender UIs.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionSenderUiListResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/SigningSessionSenderUiListResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/200/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/SigningSessionSenderUiListResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionSenderUiListResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/getsigningsessionsenderuis"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/sender-uis"},{"label":"Re-authenticate existing sender UI","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/authenticatesigningsessionsenderui","routeSlug":"/embed-api/openapi/signing/authenticatesigningsessionsenderui","metadata":{"seo":{"title":"Re-authenticate existing sender UI","description":"Create a new one-time authentication URL for an existing Sender UI.Use this when the previous URL has expired or has already been used."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"authenticateSigningSessionSenderUi","name":"Re-authenticate existing sender UI","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Re-authenticate existing sender UI","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new one-time authentication URL for an existing Sender UI."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this when the previous URL has expired or has already been used."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See details about URL behavior in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/createSigningSessionSenderUi"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"create sender UI"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true},{"name":"sender_ui_id","in":"path","schemaId":"schema_31","description":"The UUID of the sender UI to authenticate.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/sign/sessions/{session_id}/sender-uis/{sender_ui_id}/authenticate","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"},{"name":"sender_ui_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88401","schemaId":"schema_31"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","404"],"pointer":"/sign/sessions/{session_id}/sender-uis/{sender_ui_id}/authenticate","href":"signing/authenticatesigningsessionsenderui","openApiOperationId":"authenticateSigningSessionSenderUi","summary":"Re-authenticate existing sender UI"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AuthenticateParticipantPayload","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Successfully authenticated sender UI.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionSenderUiAuthenticatedResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/SigningSessionSenderUiAuthenticatedResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/201/content/application~1json/example"]},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/SigningSessionSenderUiAuthenticatedResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SigningSessionSenderUiAuthenticatedResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/201/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/authenticatesigningsessionsenderui"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/sender-uis/{sender_ui_id}/authenticate"},{"label":"Remove sender UI from signing session","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/embed-api/openapi/signing/removesigningsessionsenderui","routeSlug":"/embed-api/openapi/signing/removesigningsessionsenderui","metadata":{"seo":{"title":"Remove sender UI from signing session","description":"Remove an existing Sender UI resource from the signing session."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"removeSigningSessionSenderUi","name":"Remove sender UI from signing session","isWebhook":false,"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove sender UI from signing session","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Remove an existing Sender UI resource from the signing session.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"APIKey","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"session_id","in":"path","schemaId":"schema_22","description":"The UUID of the signing session.","required":true},{"name":"sender_ui_id","in":"path","schemaId":"schema_31","description":"The UUID of the sender UI to remove.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept","in":"header","schemaId":"schema_0","description":"Specify the response format.","required":true}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/sign/sessions/{session_id}/sender-uis/{sender_ui_id}","servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"parameters":{"path":[{"name":"session_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","schemaId":"schema_22"},{"name":"sender_ui_id","in":"path","required":true,"example":"0196ae5b-2e9d-729f-aba5-fa4db6f88401","schemaId":"schema_31"}],"query":[],"querystring":[],"header":[{"name":"Accept","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key"}],"scopes":[]}],"responseCodes":["204","404"],"pointer":"/sign/sessions/{session_id}/sender-uis/{sender_ui_id}","href":"signing/removesigningsessionsenderui","openApiOperationId":"removeSigningSessionSenderUi","summary":"Remove sender UI from signing session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"Successfully removed the sender UI. No content is returned."},{"code":"404","description":"Resource not found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete/responses/404/content/application~1json/example"]}],"pointer":"/paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"204"},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete/responses/404/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/signing/removesigningsessionsenderui"}],"panels":[]}]},"httpPath":"/sign/sessions/{session_id}/sender-uis/{sender_ui_id}"}],"content":{"contentType":"group","meta":{"name":"Signing"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Signing","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Start a signing session by providing files and participants."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/signing"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sign Engine"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for integration concepts, invitations,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and retrieving signed documents. See"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/signing/webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Signing webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for event types."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/sign/sessions","summary":"Create a signing session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/createsigningsession","deprecated":false},{"title":"/sign/sessions/{session_id}","summary":"Retrieve details of existing signing session","prefix":{"name":"get","color":"get"},"badges":[],"link":"/signing/getsigningsession","deprecated":false},{"title":"/sign/sessions/{session_id}","summary":"End signing session","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/signing/endsigningsession","deprecated":false},{"title":"/sign/sessions/{session_id}/start","summary":"Start signing session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/startsigningsession","deprecated":false},{"title":"/sign/sessions/{session_id}/renew","summary":"Renew expired signing session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/renewsigningsession","deprecated":false},{"title":"/sign/sessions/{session_id}/pdf","summary":"Get signing session PDF","prefix":{"name":"get","color":"get"},"badges":[],"link":"/signing/getsigningsessionpdf","deprecated":false},{"title":"/sign/sessions/{session_id}/webhooks","summary":"List recent webhook delivery attempts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/signing/listsigningsessionwebhookcalls","deprecated":false},{"title":"/sign/sessions/{session_id}/audit","summary":"List audit records for a signing session","prefix":{"name":"get","color":"get"},"badges":[],"link":"/signing/listsigningsessionauditrecords","deprecated":false},{"title":"/sign/sessions/{session_id}/files","summary":"Add new file to signing session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/createsigningsessionfile","deprecated":false},{"title":"/sign/sessions/{session_id}/participants","summary":"Add new participant to signing session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/createsigningsessionparticipant","deprecated":false},{"title":"/sign/sessions/{session_id}/participants/{participant_id}","summary":"Remove participant from signing session","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/signing/removesigningsessionparticipant","deprecated":false},{"title":"/sign/sessions/{session_id}/participants/{participant_id}/excuse","summary":"Excuse participant from signing on started session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/excusesigningsessionparticipant","deprecated":false},{"title":"/sign/sessions/{session_id}/participants/{participant_id}/reinstate","summary":"Reinstate a declined participant","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/reinstatesigningsessionparticipant","deprecated":false},{"title":"/sign/sessions/{session_id}/participants/{participant_id}/invitations","summary":"Create invitation for participant","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/createsigningsessionparticipantinvitation","deprecated":false},{"title":"/sign/sessions/{session_id}/participants/{participant_id}/invitations/{invitation_id}/resend","summary":"Resend an invitation","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/resendsigningsessionparticipantinvitation","deprecated":false},{"title":"/sign/sessions/{session_id}/participants/{participant_id}/invitations/{invitation_id}","summary":"Revoke a previously created invitation","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/signing/deletesigningsessionparticipantinvitation","deprecated":false},{"title":"/sign/sessions/{session_id}/sender-uis","summary":"Create sender UI for signing session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/createsigningsessionsenderui","deprecated":false},{"title":"/sign/sessions/{session_id}/sender-uis","summary":"List sender interfaces for signing session","prefix":{"name":"get","color":"get"},"badges":[],"link":"/signing/getsigningsessionsenderuis","deprecated":false},{"title":"/sign/sessions/{session_id}/sender-uis/{sender_ui_id}/authenticate","summary":"Re-authenticate existing sender UI","prefix":{"name":"post","color":"post"},"badges":[],"link":"/signing/authenticatesigningsessionsenderui","deprecated":false},{"title":"/sign/sessions/{session_id}/sender-uis/{sender_ui_id}","summary":"Remove sender UI from signing session","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/signing/removesigningsessionsenderui","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/CreateBrowserSessionPayload":{"id":"components/schemas/CreateBrowserSessionPayload","kind":"json-schema","title":"CreateBrowserSessionPayload","data":{"additionalProperties":false,"properties":{"handlers":{"$ref":"#/components/schemas/App.Payload.Primitives.HandlersPayload.HandlersPayload"},"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"}},"required":["handlers"],"type":"object"}},"components/schemas/BrowserSessionCreatedData":{"id":"components/schemas/BrowserSessionCreatedData","kind":"json-schema","title":"BrowserSessionCreatedData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"url":{"type":"string"}},"required":["id","url"],"type":"object"}},"components/schemas/BrowserSessionData":{"id":"components/schemas/BrowserSessionData","kind":"json-schema","title":"BrowserSessionData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"state":{"anyOf":[{"$ref":"#/components/schemas/App.Data.BrowserSession.BrowserSessionStateData.BrowserSessionStateData"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/App.Enums.BrowserSessionStatus"}},"required":["id","status","state"],"type":"object"}},"components/schemas/CreateBuilderSessionPayload":{"id":"components/schemas/CreateBuilderSessionPayload","kind":"json-schema","title":"CreateBuilderSessionPayload","data":{"type":"object","additionalProperties":false,"properties":{"contract":{"$ref":"#/components/schemas/Api.BuilderSession.Payload.ContractPayload.ContractPayload"},"handlers":{"$ref":"#/components/schemas/App.Payload.Primitives.HandlersPayload.HandlersPayload"},"participant":{"$ref":"#/components/schemas/App.Payload.Primitives.ParticipantPayload.ParticipantPayload"},"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"},"trial":{"anyOf":[{"$ref":"#/components/schemas/BuilderSessionTrial"},{"type":"null"}]},"finalization":{"anyOf":[{"$ref":"#/components/schemas/BuilderSessionFinalization"},{"type":"null"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional finalization confirmation behavior for the finalize dialog."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (or omit) to use the default Builder UI behavior."},"children":[]}]}]}]}},"required":["contract","handlers"]}},"components/schemas/AuthenticateParticipantPayload":{"id":"components/schemas/AuthenticateParticipantPayload","kind":"json-schema","title":"AuthenticateParticipantPayload","data":{"type":"object","additionalProperties":false,"properties":{"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"}}}},"components/schemas/AddParticipantPayload":{"id":"components/schemas/AddParticipantPayload","kind":"json-schema","title":"AddParticipantPayload","data":{"type":"object","additionalProperties":false,"properties":{"participant":{"$ref":"#/components/schemas/App.Payload.Primitives.ParticipantPayload.ParticipantPayload"},"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"}},"required":["participant"]}},"components/schemas/ParticipantAuthenticatedData":{"id":"components/schemas/ParticipantAuthenticatedData","kind":"json-schema","title":"ParticipantAuthenticatedData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"participant":{"$ref":"#/components/schemas/App.Data.Primitives.ParticipantData.ParticipantData"},"url":{"type":"string"}},"required":["id","url","participant"],"type":"object"}},"components/schemas/BuilderSessionCreatedData":{"id":"components/schemas/BuilderSessionCreatedData","kind":"json-schema","title":"BuilderSessionCreatedData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"participant":{"$ref":"#/components/schemas/App.Data.Primitives.ParticipantData.ParticipantData"},"url":{"type":"string"}},"required":["id","url","participant"],"type":"object"}},"components/schemas/BuilderSessionData":{"id":"components/schemas/BuilderSessionData","kind":"json-schema","title":"BuilderSessionData","data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"status":{"$ref":"#/components/schemas/App.Enums.BuilderSessionStatus"},"participants":{"type":"array","items":{"$ref":"#/components/schemas/App.Data.Primitives.ParticipantData.ParticipantData"}},"trial":{"anyOf":[{"$ref":"#/components/schemas/BuilderSessionTrial"},{"type":"null"}]},"finalization":{"anyOf":[{"$ref":"#/components/schemas/BuilderSessionFinalization"},{"type":"null"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Finalization confirmation settings currently configured for this session."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means the default Builder UI behavior is used."},"children":[]}]}]}]},"_data_type":{"type":"string"}},"required":["id","status","participants","trial","finalization"]}},"components/schemas/BuilderSessionFinalization":{"id":"components/schemas/BuilderSessionFinalization","kind":"json-schema","title":"BuilderSessionFinalization","data":{"type":"object","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Finalization confirmation settings for the finalize dialog."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confirmation_enabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required whenever "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalization"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These settings are ignored while trial mode is enabled ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"trial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"properties":{"confirmation_enabled":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enables custom confirmation behavior in the finalize dialog."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", Builder shows either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"confirmation_text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (if provided) or its default confirmation copy."},"children":[]}]}]}]},"confirmation_text":{"anyOf":[{"type":"string","maxLength":255,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional custom message. HTML supported. Allowed tags: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"strong"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"b"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"wbr"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"<strong>Please review carefully.</strong> This action cannot be undone."},{"type":"null","description":"Default confirmation copy is used."}]}},"required":["confirmation_enabled"]}},"components/schemas/BuilderSessionTrial":{"id":"components/schemas/BuilderSessionTrial","kind":"json-schema","title":"BuilderSessionTrial","data":{"type":"object","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Trial mode configuration shown in the Builder UI. When trial mode is enabled, the session cannot be finalized."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"heading_text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalize_content"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" support sanitized HTML. Other text fields are plain text only."},"children":[]}]}]}],"properties":{"cta_url":{"type":"string","format":"uri","pattern":"^https?://","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Trial CTA target URL. Must be an absolute "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"http"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" URL (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"http://localhost:3000/plans"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in development)."},"children":[]}]}]}],"example":"https://example.com/trial"},"heading_text":{"type":"string","maxLength":240,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Main trial heading. HTML is sanitized and only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"strong"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"b"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"wbr"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" tags are preserved. Unsupported tags are stripped."},"children":[]}]}]}],"example":"<strong>Free trial</strong> - Upgrade to unlock full preview, downloads, and e-signing."},"heading_cta_text":{"type":"string","minLength":2,"maxLength":30,"description":"CTA label in the heading area. Plain text only (HTML not supported). Length must be 2-30 characters.","example":"Explore plans"},"preview_text":{"type":"string","maxLength":240,"description":"Text shown in preview mode lock state. Plain text only (HTML not supported).","example":"Unlock full preview"},"finalize_title":{"type":"string","maxLength":240,"description":"Title shown on the finalize step in trial mode. Plain text only (HTML not supported).","example":"Finish and use your document"},"finalize_content":{"type":"string","maxLength":240,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Finalize step content. HTML is sanitized and only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"strong"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"b"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"wbr"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"br"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"li"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ul"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"h2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"h3"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"h4"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"p"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" tags are preserved. Unsupported tags are stripped."},"children":[]}]}]}],"example":"<h3>Your document is ready.</h3><p>Upgrade to:</p><ul><li>View the full document</li><li>Download it as a PDF</li><li>Send it for signing</li></ul>"},"finalize_cta_text":{"type":"string","minLength":2,"maxLength":30,"description":"CTA label on the finalize step. Plain text only (HTML not supported). Length must be 2-30 characters.","example":"Explore plans"}},"required":["cta_url","heading_text","heading_cta_text","preview_text","finalize_title","finalize_content","finalize_cta_text"]}},"components/schemas/PatchBuilderSessionPayload":{"id":"components/schemas/PatchBuilderSessionPayload","kind":"json-schema","title":"PatchBuilderSessionPayload","data":{"type":"object","additionalProperties":false,"properties":{"trial":{"anyOf":[{"$ref":"#/components/schemas/BuilderSessionTrial"},{"type":"null"}]},"finalization":{"anyOf":[{"$ref":"#/components/schemas/BuilderSessionFinalization"},{"type":"null"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to clear previously set finalization settings and restore default Builder UI behavior."},"children":[]}]}]}]}}}},"components/schemas/ImportBuilderSessionPayload":{"id":"components/schemas/ImportBuilderSessionPayload","kind":"json-schema","title":"ImportBuilderSessionPayload","data":{"type":"object","additionalProperties":false,"properties":{"session_file":{"type":"string","format":"binary","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ZIP archive exported from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/api/builder/sessions/{session_id}/export"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"handlers":{"$ref":"#/components/schemas/App.Payload.Primitives.HandlersPayload.HandlersPayload"},"participant":{"$ref":"#/components/schemas/App.Payload.Primitives.ParticipantPayload.ParticipantPayload"},"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"}},"required":["session_file","handlers"]}},"components/schemas/BuilderSessionImportResponse":{"id":"components/schemas/BuilderSessionImportResponse","kind":"json-schema","title":"BuilderSessionImportResponse","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Api.BuilderSession.Data.BuilderSessionCreatedData.BuilderSessionCreatedData"}},"required":["data"]}},"components/schemas/BuilderSessionExportFile":{"id":"components/schemas/BuilderSessionExportFile","kind":"json-schema","title":"BuilderSessionExportFile","data":{"type":"string","format":"binary","description":"ZIP archive containing exported builder session data."}},"components/schemas/CreateSigningSessionPayload":{"id":"components/schemas/CreateSigningSessionPayload","kind":"json-schema","title":"CreateSigningSessionPayload","data":{"type":"object","additionalProperties":false,"required":["document_name","document_author"],"properties":{"document_name":{"type":"string","minLength":1,"maxLength":200,"description":"Name of the document shown in the signing UI.\n","example":"Employment Agreement"},"document_author":{"type":"string","minLength":1,"maxLength":100,"description":"Author name associated with the document.\n","example":"HR Department"},"external_id":{"$ref":"#/components/schemas/SigningSessionExternalId"},"expires_at":{"$ref":"#/components/schemas/SigningSessionExpirationTime"},"ui_domain":{"allOf":[{"$ref":"#/components/schemas/SigningSessionUiDomain"}]},"email_from":{"allOf":[{"$ref":"#/components/schemas/SigningSessionEmailFrom"}]},"start":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the signing session is started immediately after creation. If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the created session status is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"started"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (or omitted), status is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Starting a session locks its files (no files can be added or removed) and allows participants to access the signing flow via their links. Queued invitations are sent when the session starts."},"children":[]}]}]}],"example":true},"signature_position":{"$ref":"#/components/schemas/SigningSessionSignaturePosition"},"files":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional list of files for the signing session. If multiple files are provided, they are merged into a single PDF. When using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", each file must include a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". When using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" can be omitted — files without a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are matched by position to the uploaded binary parts."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/SigningSessionFileInput"}},"participants":{"type":"array","maxItems":40,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Signers for the signing session, including any added after creation while the session is in a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" state."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/SigningSessionParticipant"}},"webhooks":{"type":"array","maxItems":2,"items":{"$ref":"#/components/schemas/SigningSessionWebhook"}}}}},"components/schemas/SigningSuccessResponse":{"id":"components/schemas/SigningSuccessResponse","kind":"json-schema","title":"SigningSuccessResponse","data":{"type":"object","properties":{"data":{"description":"Response body. Null when there is nothing to return."},"meta":{"type":"object","properties":{"status":{"type":"object","properties":{"code":{"type":"integer"},"text":{"type":"string"}},"required":["code","text"]},"pagination":{"type":"object","description":"Present when the result is paged. Send the next pointer back to read the following page.","properties":{"items":{"type":"integer","minimum":0,"description":"How many records are in this page."},"total":{"type":["integer","null"],"minimum":0,"description":"How many records match in total. Empty when the total was not counted."},"last_page":{"type":["integer","null"],"minimum":1,"description":"Last page number for this page size. Empty when the total was not counted."},"page_size":{"type":"integer","minimum":1,"description":"Maximum number of records in a page."},"has_pages":{"type":"boolean","description":"Whether another page exists before or after this one."},"is_first":{"type":"boolean","description":"Whether this is the first page."},"pointer":{"type":"object","properties":{"previous":{"type":["string","null"],"description":"Pointer to the previous page. Empty on the first page."},"current":{"type":["string","null"],"description":"Pointer for this page. Empty on the first page."},"next":{"type":["string","null"],"description":"Pointer to the next page. Empty on the last page."}},"required":["previous","current","next"]}},"required":["items","total","last_page","page_size","has_pages","is_first","pointer"]}},"required":["status"]}},"required":["data","meta"]}},"components/schemas/SigningSessionResponse":{"id":"components/schemas/SigningSessionResponse","kind":"json-schema","title":"SigningSessionResponse","data":{"allOf":[{"$ref":"#/components/schemas/SigningSuccessResponse"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SigningSessionData"}}}]}},"components/schemas/SigningSessionFileCreatePayload":{"id":"components/schemas/SigningSessionFileCreatePayload","kind":"json-schema","title":"SigningSessionFileCreatePayload","data":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","example":"Appendix A - Terms.pdf"},"url":{"type":"string","format":"uri","example":"https://example.com/files/appendix-a-terms.pdf"},"index":{"type":"integer","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional zero-based index where the file is inserted in the session "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"files"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array. If omitted, the file is appended to the end."},"children":[]}]}]}],"example":1}},"required":["name","url"]}},"components/schemas/SigningSessionFileUploadData":{"id":"components/schemas/SigningSessionFileUploadData","kind":"json-schema","title":"SigningSessionFileUploadData","data":{"type":"object","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON payload for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" part of a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" file upload request."},"children":[]}]}]}],"properties":{"name":{"type":"string","description":"Display name for the file.","example":"Appendix A - Terms.pdf"},"index":{"type":"integer","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional zero-based index where the file is inserted in the session "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"files"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array. If omitted, the file is appended to the end."},"children":[]}]}]}],"example":1}},"required":["name"]}},"components/schemas/SigningSessionFileResponse":{"id":"components/schemas/SigningSessionFileResponse","kind":"json-schema","title":"SigningSessionFileResponse","data":{"allOf":[{"$ref":"#/components/schemas/SigningSuccessResponse"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SigningSessionFile"}}}}]}},"components/schemas/SigningSessionParticipantResponse":{"id":"components/schemas/SigningSessionParticipantResponse","kind":"json-schema","title":"SigningSessionParticipantResponse","data":{"allOf":[{"$ref":"#/components/schemas/SigningSuccessResponse"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SigningSessionParticipantData"}}}]}},"components/schemas/SigningSessionParticipantInvitationResponse":{"id":"components/schemas/SigningSessionParticipantInvitationResponse","kind":"json-schema","title":"SigningSessionParticipantInvitationResponse","data":{"allOf":[{"$ref":"#/components/schemas/SigningSuccessResponse"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SigningSessionParticipantInvitationData"}}}]}},"components/schemas/CreateSigningSessionSenderUiPayload":{"id":"components/schemas/CreateSigningSessionSenderUiPayload","kind":"json-schema","title":"CreateSigningSessionSenderUiPayload","data":{"type":"object","additionalProperties":false,"properties":{"handlers":{"$ref":"#/components/schemas/SigningSessionSenderUiHandlersPayload"},"configuration":{"$ref":"#/components/schemas/SigningSessionSenderUiConfiguration"},"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"}},"required":["handlers"]}},"components/schemas/AuthenticateSigningSessionSenderUiPayload":{"id":"components/schemas/AuthenticateSigningSessionSenderUiPayload","kind":"json-schema","title":"AuthenticateSigningSessionSenderUiPayload","data":{"type":"object","additionalProperties":false,"properties":{"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"}}}},"components/schemas/SigningSessionSenderUiAuthenticatedResponse":{"id":"components/schemas/SigningSessionSenderUiAuthenticatedResponse","kind":"json-schema","title":"SigningSessionSenderUiAuthenticatedResponse","data":{"allOf":[{"$ref":"#/components/schemas/SigningSuccessResponse"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SigningSessionSenderUiAuthenticatedData"}}}]}},"components/schemas/SigningSessionSenderUiListResponse":{"id":"components/schemas/SigningSessionSenderUiListResponse","kind":"json-schema","title":"SigningSessionSenderUiListResponse","data":{"allOf":[{"$ref":"#/components/schemas/SigningSuccessResponse"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SigningSessionSenderUiData"}}}}]}},"components/schemas/SigningSessionSenderUiData":{"id":"components/schemas/SigningSessionSenderUiData","kind":"json-schema","title":"SigningSessionSenderUiData","data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88401"},"handlers":{"$ref":"#/components/schemas/SigningSessionSenderUiHandlersPayload"},"configuration":{"$ref":"#/components/schemas/SigningSessionSenderUiConfiguration"},"created_at":{"type":"string","format":"date-time","example":"2026-02-12T10:30:00Z"},"updated_at":{"type":"string","format":"date-time","example":"2026-02-12T10:35:00Z"},"last_authenticated_at":{"type":"string","format":"date-time","description":"Timestamp of the latest successful authentication URL issuance.","example":"2026-02-12T10:35:00Z"}},"required":["id","handlers","created_at","updated_at","last_authenticated_at"]}},"components/schemas/SigningSessionSenderUiAuthenticatedData":{"id":"components/schemas/SigningSessionSenderUiAuthenticatedData","kind":"json-schema","title":"SigningSessionSenderUiAuthenticatedData","data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88401"},"url":{"type":"string","format":"uri","description":"One-time URL to open the Sender UI. Valid for 15 minutes and single-use.","example":"https://sign.docue.com/sender-session/0196ae5b-2e9d-729f-aba5-fa4db6f88401#access-code"},"handlers":{"$ref":"#/components/schemas/SigningSessionSenderUiHandlersPayload"},"configuration":{"$ref":"#/components/schemas/SigningSessionSenderUiConfiguration"},"created_at":{"type":"string","format":"date-time","example":"2026-02-12T10:30:00Z"},"updated_at":{"type":"string","format":"date-time","example":"2026-02-12T10:35:00Z"},"last_authenticated_at":{"type":"string","format":"date-time","description":"Timestamp of the latest successful authentication URL issuance.","example":"2026-02-12T10:35:00Z"}},"required":["id","url","handlers","created_at","updated_at","last_authenticated_at"]}},"components/schemas/SigningSessionSenderUiHandlersPayload":{"id":"components/schemas/SigningSessionSenderUiHandlersPayload","kind":"json-schema","title":"SigningSessionSenderUiHandlersPayload","data":{"type":"object","additionalProperties":false,"properties":{"return_handler":{"$ref":"#/components/schemas/App.Payload.Primitives.HandlerPayload.HandlerPayload"}},"required":["return_handler"]}},"components/schemas/SigningSessionSenderUiConfiguration":{"id":"components/schemas/SigningSessionSenderUiConfiguration","kind":"json-schema","title":"SigningSessionSenderUiConfiguration","data":{"type":"object","additionalProperties":false,"properties":{"editable_parts":{"type":"array","minItems":1,"uniqueItems":true,"description":"Which parts of the signing session can be edited in Sender UI. If omitted, all parts are editable.","items":{"$ref":"#/components/schemas/SigningSessionSenderUiEditablePart"}},"allowed_signing_methods":{"type":"array","minItems":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Templates that constrain the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signing_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the sender can configure for each"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"participant in this Sender UI session. Same item shape as a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signing_methods"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"entry ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SigningSessionAuthMethod"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). If omitted, the sender may configure any"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"method available to the workspace."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validation: every entry in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"participant.signing_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must match some entry in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"allowed_signing_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and either the template's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is omitted (any target allowed for this type), or the participant's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" equals the template's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". To permit multiple target values"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for one type (e.g., multiple eID providers), list multiple template"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"entries."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/SigningSessionAuthMethod"}},"allow_start":{"type":"boolean","default":true,"description":"Whether Sender UI can start the signing session.","example":true}}}},"components/schemas/SigningSessionSenderUiEditablePart":{"id":"components/schemas/SigningSessionSenderUiEditablePart","kind":"json-schema","title":"SigningSessionSenderUiEditablePart","data":{"type":"string","enum":["files","participants","invitations","reminders","start_session"],"example":"participants"}},"components/schemas/SigningSessionStatus":{"id":"components/schemas/SigningSessionStatus","kind":"json-schema","title":"SigningSessionStatus","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lifecycle status of the signing session."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": session created; files and participants can still be changed"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"starting"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": start is in progress"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"started"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": signing is open; participants can access Sign UI"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": all participants have signed"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": session was cancelled after signing started"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": session expired before completion"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"discarded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": session was discarded"},"children":[]}]}]}]}],"enum":["pending","starting","started","completed","cancelled","expired","discarded"],"example":"pending"}},"components/schemas/SigningSessionParticipantStatus":{"id":"components/schemas/SigningSessionParticipantStatus","kind":"json-schema","title":"SigningSessionParticipantStatus","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lifecycle status of a participant on a signing session."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": created; has not yet opened Sign UI"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"viewing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": participant has opened Sign UI"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": signing in progress"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": participant has signed"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"declined"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": participant declined to sign"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"excused"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": participant was excused from signing"},"children":[]}]}]}]}],"enum":["pending","viewing","signing","signed","declined","excused"],"example":"pending"}},"components/schemas/SigningSessionData":{"id":"components/schemas/SigningSessionData","kind":"json-schema","title":"SigningSessionData","data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd"},"status":{"$ref":"#/components/schemas/SigningSessionStatus"},"document_name":{"type":"string","minLength":1,"maxLength":200,"description":"Name of the document shown in the signing UI.","example":"Employment Agreement"},"document_author":{"type":"string","minLength":1,"maxLength":100,"description":"Author name associated with the document.","example":"HR Department"},"external_id":{"anyOf":[{"$ref":"#/components/schemas/SigningSessionExternalId"},{"type":"null"}]},"signature_position":{"$ref":"#/components/schemas/SigningSessionSignaturePosition"},"expires_at":{"$ref":"#/components/schemas/SigningSessionExpirationTime"},"ui_domain":{"anyOf":[{"$ref":"#/components/schemas/SigningSessionUiDomain"},{"type":"null"}]},"email_from":{"anyOf":[{"$ref":"#/components/schemas/SigningSessionEmailFrom"},{"type":"null"}]},"files":{"type":"array","items":{"$ref":"#/components/schemas/SigningSessionFile"}},"participants":{"type":"array","maxItems":40,"description":"Signers on the signing session.","items":{"$ref":"#/components/schemas/SigningSessionParticipantData"}},"webhooks":{"type":"array","maxItems":2,"items":{"$ref":"#/components/schemas/SigningSessionWebhookData"}}},"required":["id","status","document_name","document_author","external_id","signature_position","expires_at","ui_domain","email_from"]}},"components/schemas/SigningSessionUiDomain":{"id":"components/schemas/SigningSessionUiDomain","kind":"json-schema","title":"SigningSessionUiDomain","data":{"type":"string","format":"hostname","description":"A custom domain registered for your workspace. This session's UI is served from it.\n","example":"sign.acme.com"}},"components/schemas/SigningSessionEmailFrom":{"id":"components/schemas/SigningSessionEmailFrom","kind":"json-schema","title":"SigningSessionEmailFrom","data":{"type":"string","description":"From address for invitation emails sent for this session. The domain must be an email domain registered for your workspace.\n","example":"\"Acme\" <sign@mail.acme.com>"}},"components/schemas/SigningSessionExternalId":{"id":"components/schemas/SigningSessionExternalId","kind":"json-schema","title":"SigningSessionExternalId","data":{"type":"string","minLength":1,"maxLength":100,"description":"Your own identifier for correlating this session in your system.","example":"deal-42"}},"components/schemas/SigningSessionExpirationTime":{"id":"components/schemas/SigningSessionExpirationTime","kind":"json-schema","title":"SigningSessionExpirationTime","data":{"type":"string","format":"date-time","description":"Expiration time as an RFC 3339 timestamp, including a timezone. Must be at least one hour and no more than 180 days after creation. Defaults to 180 days.\n","example":"2026-03-31T10:30:00.000Z"}},"components/schemas/SigningSessionParticipantExternalId":{"id":"components/schemas/SigningSessionParticipantExternalId","kind":"json-schema","title":"SigningSessionParticipantExternalId","data":{"type":"string","minLength":1,"maxLength":100,"description":"Your own identifier for correlating this participant in your system.","example":"user-123"}},"components/schemas/SigningSessionSignaturePosition":{"id":"components/schemas/SigningSessionSignaturePosition","kind":"json-schema","title":"SigningSessionSignaturePosition","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where signatures are placed in the final PDF."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inline"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": signatures are placed in the provided participant "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signature_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Participants without a location remain invisible but are still digitally signed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"start"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": a separate signature page is attached to the beginning of the PDF."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"end"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": a separate signature page is attached to the end of the PDF."},"children":[]}]}]}]}],"enum":["inline","start","end"],"example":"inline"}},"components/schemas/SigningSessionFileInput":{"id":"components/schemas/SigningSessionFileInput","kind":"json-schema","title":"SigningSessionFileInput","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"File entry for creating a signing session. When using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required. When using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" can be omitted — the file content is provided as an uploaded binary part instead."},"children":[]}]}]}],"additionalProperties":false,"properties":{"name":{"type":"string","description":"Display name for the file.","example":"Employment Agreement.pdf"},"url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to fetch the file from. Required when using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Can be omitted when uploading the file directly via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://example.com/files/employment-agreement.pdf"}},"required":["name"]}},"components/schemas/SigningSessionFile":{"id":"components/schemas/SigningSessionFile","kind":"json-schema","title":"SigningSessionFile","data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"file_name":{"type":"string","example":"Employment Agreement.pdf"},"file_size":{"type":"integer","minimum":0},"index":{"type":"integer","minimum":0,"description":"Zero-based position of the file in the session."}},"required":["id","file_name","file_size","index"]}},"components/schemas/SigningSessionParticipant":{"id":"components/schemas/SigningSessionParticipant","kind":"json-schema","title":"SigningSessionParticipant","data":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","example":"John Doe"},"external_id":{"$ref":"#/components/schemas/SigningSessionParticipantExternalId"},"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"},"signing_order":{"type":"integer","minimum":0,"default":0,"description":"Participants sign in ascending order from 0 to N. Participants sharing the same value sign in parallel.","example":0},"deliveries":{"type":"array","minItems":1,"description":"How invitations reach this participant. At least one is required. Email and SMS are queued until the session starts.\n","items":{"$ref":"#/components/schemas/SigningSessionParticipantInvitation"}},"signing_methods":{"type":"array","minItems":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of allowed signature methods for this participant. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type: password"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 type_not_allowed_for_signing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — passwords can only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"be used in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"view_gate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not as a signing method."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/SigningSessionAuthMethod"}},"view_gate":{"allOf":[{"$ref":"#/components/schemas/SigningSessionAuthMethod"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional view gate. The signer must clear this authentication step before"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the document is exposed. Same shape as a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signing_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entry"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{ type, target? }"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Supported types: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"otp_email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"otp_sms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". When omitted, no view gate is enforced."},"children":[]}]}]}]},"signature_location":{"allOf":[{"$ref":"#/components/schemas/SigningSessionSignatureLocation"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Signature location for this participant. Used when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signature_position"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inline"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". If omitted in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inline"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" mode, the signature is invisible but still digitally signed."},"children":[]}]}]}]}},"required":["name","deliveries"]}},"components/schemas/SigningSessionParticipantData":{"id":"components/schemas/SigningSessionParticipantData","kind":"json-schema","title":"SigningSessionParticipantData","data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88211"},"status":{"$ref":"#/components/schemas/SigningSessionParticipantStatus"},"status_changed_at":{"type":"string","format":"date-time","description":"When the participant status last changed."},"decline_reason":{"type":"string","minLength":1,"maxLength":200,"description":"Reason given when the participant declined.","example":"Terms are not acceptable"},"name":{"type":"string","example":"John Doe"},"external_id":{"anyOf":[{"$ref":"#/components/schemas/SigningSessionParticipantExternalId"},{"type":"null"}]},"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"},"signing_order":{"type":"integer","minimum":0,"default":0,"description":"Participants sign in ascending order from 0 to N. Participants sharing the same value sign in parallel.","example":0},"invitations":{"type":"array","minItems":1,"description":"Optional list of invitations for this participant.","items":{"$ref":"#/components/schemas/SigningSessionParticipantInvitationData"}},"signing_methods":{"type":"array","minItems":1,"description":"List of allowed signature methods for this participant.","items":{"$ref":"#/components/schemas/SigningSessionAuthMethod"}},"view_gate":{"allOf":[{"$ref":"#/components/schemas/SigningSessionAuthMethod"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View gate configuration, if one was set at create/update time."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type: \"password\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned on subsequent reads."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The single exception: when a request creates or rotates a password gate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"without supplying a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (i.e. the server generates one —"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"view_gate: { type: \"password\" }"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), the response to "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that one request"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"carries the generated plaintext as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"view_gate.target"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". You must capture it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"on the originating response and deliver it to the signer through a separate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"channel; it is not retrievable later."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type: \"eid\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (when set) reflects the pinned provider key."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type: \"otp_email\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"otp_sms\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is always omitted (signer-"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"entered at challenge time)."},"children":[]}]}]}]}},"required":["id","status","status_changed_at","name","external_id"]}},"components/schemas/SigningSessionParticipantInvitationTimeline":{"id":"components/schemas/SigningSessionParticipantInvitationTimeline","kind":"json-schema","title":"SigningSessionParticipantInvitationTimeline","data":{"type":"object","additionalProperties":false,"properties":{"created_at":{"type":"string","format":"date-time","description":"When the invitation was created.","example":"2026-06-30T11:04:45.331Z"},"sent_at":{"type":["string","null"],"format":"date-time","description":"When the invitation was sent, or null if not yet sent.","example":null},"opened_at":{"type":["string","null"],"format":"date-time","description":"When the recipient first opened the signing link, or null if not yet opened.","example":null},"revoked_at":{"type":["string","null"],"format":"date-time","description":"When the invitation was revoked, or null if still active.","example":null}},"required":["created_at","sent_at","opened_at","revoked_at"]}},"components/schemas/SigningSessionParticipantInvitationData":{"id":"components/schemas/SigningSessionParticipantInvitationData","kind":"json-schema","title":"SigningSessionParticipantInvitationData","data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88311"},"signing_url":{"type":"string","format":"uri","description":"URL to open the signing flow for this invitation. Present only for manual delivery, when you share the link yourself. Omitted for email or SMS, which Docue delivers.\n","example":"https://sign.docue.com/s/#access-code"},"delivery":{"$ref":"#/components/schemas/SigningSessionParticipantInvitation"},"timeline":{"$ref":"#/components/schemas/SigningSessionParticipantInvitationTimeline"}},"required":["id","delivery","timeline"]}},"components/schemas/SigningSessionParticipantInvitationCreate":{"id":"components/schemas/SigningSessionParticipantInvitationCreate","kind":"json-schema","title":"SigningSessionParticipantInvitationCreate","data":{"allOf":[{"$ref":"#/components/schemas/SigningSessionParticipantInvitation"}],"description":"Creates a new invitation for a participant. Manual delivery is allowed while the session is pending or started; you share the signing URL. Email or SMS delivery requires a started session.\n"}},"components/schemas/SigningSessionParticipantInvitation":{"id":"components/schemas/SigningSessionParticipantInvitation","kind":"json-schema","title":"SigningSessionParticipantInvitation","data":{"type":"object","additionalProperties":false,"description":"Invitation delivery channel. Manual means you share the signing URL; Docue does not send email or SMS. Email and SMS require a target.\n","properties":{"type":{"type":"string","enum":["email","sms","manual"],"example":"email"},"target":{"type":["string","null"],"description":"Email address or E.164 phone number. Unused for manual.","example":"john.doe@example.org"},"message":{"type":"string","maxLength":500,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional short note shown with the signing link. Not the full email or SMS body — the surrounding template is fixed."},"children":[]}]}]}],"example":"Please sign by Friday."}},"required":["type"]}},"components/schemas/SigningSessionAuthMethod":{"id":"components/schemas/SigningSessionAuthMethod","kind":"json-schema","title":"SigningSessionAuthMethod","data":{"type":"object","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An authentication method allowed for this participant. Used both for the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sign-time methods list ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signing_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") and for the optional view gate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"view_gate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Multi-value \"OR\" semantics are expressed at the list level"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signing_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"allowed_signing_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), not within a single entry."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-type "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" semantics:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": target is a specific provider id from the workspace's provider"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"catalog (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fi_nordea"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fi_op"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"se_bankid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Country-scoped providers"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are prefixed with their ISO 3166-1 alpha-2 country code; cross-border"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"providers (e.g., Smart-ID) are unprefixed. Omitted = any provider"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"available to the participant is allowed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": target is the accepted password string. Only valid in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"view_gate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (passwords are not a valid signing method); if omitted, the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"server generates a password and returns the plaintext once in the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"create/update response. Plaintext is not persisted or retrievable after that."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"otp_email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"otp_sms"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": target is optional — pre-fills the signer's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"email or phone at challenge time; the signer can edit before submitting."},"children":[]}]}]}]}],"properties":{"type":{"type":"string","enum":["password","otp_email","otp_sms","eid"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication method type. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is only valid for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"view_gate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"eid"},"target":{"type":"string","minLength":1,"description":"Optional target value for this type (see schema description).","example":"fi_nordea"}},"required":["type"]}},"components/schemas/SigningSessionSignatureLocation":{"id":"components/schemas/SigningSessionSignatureLocation","kind":"json-schema","title":"SigningSessionSignatureLocation","data":{"type":"object","additionalProperties":false,"properties":{"file_index":{"type":"integer","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Zero-based index of the file in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"files"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array where the signature area is located."},"children":[]}]}]}],"example":0},"page":{"type":"integer","minimum":1,"description":"Number of the page where the signature area is located. It is 1-based.","example":1},"x":{"type":"number","format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"X position of the signature area's location. The value is % of the page's width. For e.g. 0.10 means it is 10% of the page width."},"children":[]}]}]}],"example":0.1},"y":{"type":"number","format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Y position of the signature area's location. The value is % of the page's height. For e.g. 0.10 means it is 10% of the page height."},"children":[]}]}]}],"example":0.1},"width":{"type":"number","format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Width of the signature area. The value is % of the page's width. For e.g. 0.10 means it is 10% of the page width."},"children":[]}]}]}],"example":0.1},"height":{"type":"number","format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Height of the signature area. The value is % of the page's height. For e.g. 0.10 means it is 10% of the page height."},"children":[]}]}]}],"example":0.1}},"required":["file_index","page","x","y","width","height"]}},"components/schemas/SigningSessionWebhook":{"id":"components/schemas/SigningSessionWebhook","kind":"json-schema","title":"SigningSessionWebhook","data":{"type":"object","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A webhook endpoint that receives signing session events. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/signing/webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Signing webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for delivery behavior, event types, and signature validation."},"children":[]}]}]}],"properties":{"url":{"type":"string","format":"uri","example":"https://example.com/webhooks/signing"},"secret":{"type":"string","minLength":1,"maxLength":1024,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional secret used to sign each delivery with HMAC-SHA256. The signature covers the send time (the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"X-Webhook-Sent-At"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header) and the exact raw request body. When configured, Docue sends the lowercase hexadecimal digest in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"X-Webhook-Signature"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/signing/webhooks#verify-webhook-signatures"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verify webhook signatures"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for validation instructions and a complete example."},"children":[]}]}]}],"example":"your-shared-secret"}},"required":["url"]}},"components/schemas/SigningSessionWebhookData":{"id":"components/schemas/SigningSessionWebhookData","kind":"json-schema","title":"SigningSessionWebhookData","data":{"type":"object","additionalProperties":false,"description":"Webhook endpoint configured on the session.","properties":{"url":{"type":"string","format":"uri"},"secret_configured":{"type":"boolean","description":"Whether a signing secret was set for this endpoint."}},"required":["url","secret_configured"]}},"components/schemas/SigningWebhookEventType":{"id":"components/schemas/SigningWebhookEventType","kind":"json-schema","title":"SigningWebhookEventType","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The signing event type. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/signing/webhooks#event-types"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Signing webhook event types"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for details about when each event is sent."},"children":[]}]}]}],"enum":["com.docue.sign.v1.session.created","com.docue.sign.v1.session.started","com.docue.sign.v1.session.cancelled","com.docue.sign.v1.session.discarded","com.docue.sign.v1.session.completed","com.docue.sign.v1.session.expired","com.docue.sign.v1.session.renewed","com.docue.sign.v1.participant.added","com.docue.sign.v1.participant.removed","com.docue.sign.v1.participant.signed","com.docue.sign.v1.participant.declined","com.docue.sign.v1.participant.excused","com.docue.sign.v1.participant.reinstated","com.docue.sign.v1.invitation.created","com.docue.sign.v1.invitation.sent","com.docue.sign.v1.invitation.resent","com.docue.sign.v1.invitation.opened","com.docue.sign.v1.invitation.revoked"],"example":"com.docue.sign.v1.participant.signed"}},"components/schemas/SigningWebhookCall":{"id":"components/schemas/SigningWebhookCall","kind":"json-schema","title":"SigningWebhookCall","data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88401"},"url":{"type":"string","format":"uri","example":"https://example.com/webhooks/signing"},"status":{"type":"string","enum":["pending","delivered","exhausted"],"example":"delivered"},"event":{"type":"object","additionalProperties":false,"description":"The signing event associated with this delivery attempt. Your webhook receives this object nested under event.\n","properties":{"payload":{"type":"object","additionalProperties":true},"meta":{"type":"object","additionalProperties":false,"properties":{"type":{"$ref":"#/components/schemas/SigningWebhookEventType"},"id":{"type":"string","format":"uuid"},"timestamp":{"type":"string","format":"date-time"}},"required":["type","id","timestamp"]}},"required":["payload","meta"],"example":{"payload":{"workspace":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88001"},"session":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","external_id":"deal-42","status":"started","status_changed_at":"2026-02-12T10:30:00Z"},"participant":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","external_id":"user-123","session_id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","status":"signed","status_changed_at":"2026-02-12T10:31:00Z","decline_reason":null}},"meta":{"type":"com.docue.sign.v1.participant.signed","id":"0196ae5b-2e9d-729f-aba5-fa4db6f88411","timestamp":"2026-02-12T10:31:00Z"}}},"attempt":{"type":"integer","minimum":0,"example":1},"retry_after":{"type":["string","null"],"format":"date-time","example":null},"last_error":{"type":["string","null"],"example":null}},"required":["id","url","status","event","attempt","retry_after","last_error"]}},"components/schemas/SigningAuditRecord":{"id":"components/schemas/SigningAuditRecord","kind":"json-schema","title":"SigningAuditRecord","data":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88401"},"actor":{"type":"string","enum":["system","integrator","sender-ui","participant"],"example":"integrator"},"actor_id":{"type":["string","null"],"format":"uuid","description":"Workspace id for an integrator, participant id for a participant, sender UI id for sender-ui. Null when the actor is the system.\n","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88001"},"type":{"type":"string","example":"session.created"},"timestamp":{"type":"string","format":"date-time","example":"2026-02-12T10:30:00Z"},"client":{"type":["object","null"],"additionalProperties":false,"description":"Client that triggered the record, or null when unknown.","properties":{"ip":{"type":"string"},"user_agent":{"type":"string","maxLength":1024,"example":"Mozilla/5.0"}},"required":["ip","user_agent"]}},"required":["id","actor","actor_id","type","timestamp"]}},"components/schemas/WorkspaceData":{"id":"components/schemas/WorkspaceData","kind":"json-schema","title":"WorkspaceData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"}},"components/schemas/ContractState":{"id":"components/schemas/ContractState","kind":"json-schema","title":"ContractState","data":{"type":"object","properties":{"data":{"type":"object","properties":{"state":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["draft","finalized"],"description":"If document is finalized, it cannot be edited."},"document_name":{"type":"string","description":"Name of the document. End-users can edit this. This is not visible on the document itself."},"jurisdiction":{"type":"string","description":"Jurisdiction of the agreement.","example":"FI"},"languages":{"type":"array","items":{"type":"string"},"description":"Languages in which the document is drafted. It usually contains just one.","example":["en-GB"]},"value":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Values filled in to the form. The schema varies in every template. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/embed-api/legal-engine/document-state#update-document-field-values"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"this"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more information."},"children":[]}]}]}]},"sections":{"type":"array","items":{"type":"object"},"description":"List of sections included in the document. It contains templates and custom sections added by end-users. The sections are presented in the same order as they appear in the document."},"appearance":{"type":"object","properties":{"logo":{"type":"object","properties":{"enabled":{"type":"boolean","example":false},"content":{"type":["string","null"],"example":null,"description":"Data URI with base64 encoded JPG,PNG or SVG image."},"scale":{"type":"number","example":50,"description":"Size of the logo, scale 20-100 where 20 is the smallest and 100 is the largest."}}},"footer":{"type":"object","properties":{"enabled":{"type":"boolean","example":false},"content":{"type":"string","example":""}}},"heading1":{"type":"object","properties":{"family":{"type":"string","example":"arial"},"color":{"type":"string","example":"#000000"},"size":{"type":"string","example":"20"},"weight":{"type":"string","example":"bold"},"alignment":{"type":"string","example":"left"},"transform":{"type":"string","example":"none"}}},"heading2":{"type":"object","properties":{"family":{"type":"string","example":"arial"},"color":{"type":"string","example":"#000000"},"size":{"type":"string","example":"13"},"weight":{"type":"string","example":"bold"},"alignment":{"type":"string","example":"left"},"transform":{"type":"string","example":"none"}}},"heading3":{"type":"object","properties":{"family":{"type":"string","example":"arial"},"color":{"type":"string","example":"#000000"},"size":{"type":"string","example":"12"},"weight":{"type":"string","example":"bold"},"alignment":{"type":"string","example":"left"},"transform":{"type":"string","example":"none"}}},"heading4":{"type":"object","properties":{"family":{"type":"string","example":"arial"},"color":{"type":"string","example":"#000000"},"size":{"type":"string","example":"11"},"weight":{"type":"string","example":"bold"},"alignment":{"type":"string","example":"left"},"transform":{"type":"string","example":"none"}}},"heading5":{"type":"object","properties":{"family":{"type":"string","example":"arial"},"color":{"type":"string","example":"#000000"},"size":{"type":"string","example":"11"},"weight":{"type":"string","example":"regular"},"alignment":{"type":"string","example":"left"},"transform":{"type":"string","example":"none"}}},"heading6":{"type":"object","properties":{"family":{"type":"string","example":"arial"},"color":{"type":"string","example":"#000000"},"size":{"type":"string","example":"11"},"weight":{"type":"string","example":"regular"},"alignment":{"type":"string","example":"left"},"transform":{"type":"string","example":"none"}}},"paragraph":{"type":"object","properties":{"family":{"type":"string","example":"arial"},"color":{"type":"string","example":"#000000"},"size":{"type":"string","example":"11"},"weight":{"type":"string","example":"regular"},"alignment":{"type":"string","example":"justify"},"transform":{"type":"string","example":"none"}}},"table":{"type":"object","properties":{"family":{"type":"string","example":"arial"},"size":{"type":"string","example":"11"},"color":{"type":"string","example":"#000000"},"bgColor":{"type":"string","example":"#ffffff"},"headerBgColor":{"type":"string","example":"#e7e5e4"},"headerColor":{"type":"string","example":"#000000"},"borderColorEnabled":{"type":"boolean","example":true},"borderColor":{"type":"string","example":"#ffffff"},"alternatingRowBgColorEnabled":{"type":"boolean","example":true},"alternatingRowBgColor":{"type":"string","example":"#fafaf9"}}}}}},"description":"Contract current state"},"signees":{"type":"array","description":"List of signees found from the document.","items":{"properties":{"_type":{"type":"string","const":"signature"},"id":{"type":"string","format":"uuid","description":"Unique ID for the signature."},"first_name":{"type":"string"},"last_name":{"type":"string"},"job_title":{"type":"string"},"company_name":{"type":"string"},"fieldset_name":{"type":"string","description":"Name of the fieldset from which this signee originates."},"page":{"type":"integer","description":"Number of the page where the signature area of this signee is located. It is 1-based."},"x":{"type":"number","format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"X position of the signature area's location. The value is % of the page's width. For e.g. 0.10 means it is 10% of the page width."},"children":[]}]}]}],"example":0.1},"y":{"type":"number","format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Y position of the signature area's location. The value is % of the page's height. For e.g. 0.10 means it is 10% of the page height."},"children":[]}]}]}],"example":0.1},"width":{"type":"number","format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Width of the signature area. The value is % of the page's width. For e.g. 0.10 means it is 10% of the page width."},"children":[]}]}]}],"example":0.1},"height":{"type":"number","format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Height of the signature area. The value is % of the page's height. For e.g. 0.10 means it is 10% of the page height."},"children":[]}]}]}],"example":0.1}},"required":["id","first_name","last_name","fieldset_name","page","x","y","width","height"]}}}}}}},"components/schemas/ErrorResponse":{"id":"components/schemas/ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"type":"object","description":"Standard error response payload.","properties":{"data":{"type":"null","description":"Always null for error responses."},"meta":{"type":"object","properties":{"status":{"type":"object","properties":{"code":{"type":"integer"},"text":{"type":"string"}},"required":["code","text"]},"error":{"type":"object","properties":{"text":{"type":"string"},"details":{"type":"object","description":"Validation details, when available, as a map of what failed to a message or a list of messages.","additionalProperties":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}}},"required":["text"]}},"required":["status","error"]}},"required":["data","meta"]}},"components/schemas/ContractPatchResponse":{"id":"components/schemas/ContractPatchResponse","kind":"json-schema","title":"ContractPatchResponse","data":{"description":"Response of a processed contract patch.","allOf":[{"$ref":"#/components/schemas/ContractState"},{"type":"object","required":["meta"],"properties":{"meta":{"type":"object","required":["status","failed_operations"],"properties":{"status":{"type":"object","properties":{"code":{"type":"integer","example":200},"text":{"type":"string","example":"OK"}}},"failed_operations":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The operations that failed, in request order. Operations not listed were applied. Always empty when the request did not set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"allow_partial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/ContractPatchFailedOperation"}}}}}}]}},"components/schemas/ContractPatchFailedOperation":{"id":"components/schemas/ContractPatchFailedOperation","kind":"json-schema","title":"ContractPatchFailedOperation","data":{"type":"object","description":"A patch operation that failed and left no changes behind.","required":["index","path","error"],"properties":{"index":{"type":"integer","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Zero-based position of the operation in the request's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"operations"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array."},"children":[]}]}]}],"example":1},"path":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"path"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the operation, as sent in the request."},"children":[]}]}]}],"example":"/value/basic/title"},"error":{"type":"object","description":"Why the operation failed.","required":["code","message","details"],"properties":{"code":{"type":"string","enum":["invalid_operation","operation_failed"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-readable reason. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invalid_operation"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means the operation failed validation, for example a path that cannot be patched or a value of the wrong type. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"operation_failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means it could not be applied to the state."},"children":[]}]}]}],"example":"invalid_operation"},"message":{"type":"string","description":"Human-readable reason.","example":"Operation \"replace\" at \"/value/basic/title\" failed: invalid value"},"details":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validation details as a map of what failed to a message or a list of messages — for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the operation's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not match the field. An empty array when there are no details."},"children":[]}]}]}],"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},{"type":"array","maxItems":0}],"example":{"value":"Invalid input: expected object, received string"}}}}}}},"components/schemas/TemplateData":{"id":"components/schemas/TemplateData","kind":"json-schema","title":"TemplateData","data":{"additionalProperties":false,"properties":{"collections":{"items":{"$ref":"#/components/schemas/App.Data.Template.TemplateCollectionData.TemplateCollectionData"},"type":"array"},"created_at":{"type":"string"},"default_document_name":{"additionalProperties":{"type":"string"},"type":"object"},"description":{"additionalProperties":{"type":"string"},"type":"object"},"id":{"type":"string"},"jurisdictions":{"items":{"$ref":"#/components/schemas/App.Data.Template.JurisdictionData.JurisdictionData"},"type":"array"},"languages":{"items":{"$ref":"#/components/schemas/App.Data.Template.LanguageData.LanguageData"},"type":"array"},"short_description":{"additionalProperties":{"type":"string"},"type":"object"},"title":{"additionalProperties":{"type":"string"},"type":"object"},"updated_at":{"type":"string"}},"required":["id","title","short_description","description","default_document_name","created_at","updated_at"],"type":"object"}},"components/schemas/TemplateCollectionData":{"id":"components/schemas/TemplateCollectionData","kind":"json-schema","title":"TemplateCollectionData","data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid","example":"01965c7e-dc1e-7292-8199-8184041c1204"},"title":{"type":"object","additionalProperties":{"type":"string"},"example":{"_type":"translatable","en-GB":"Employment and HR","fi":"Työsuhde ja HR"}},"_data_type":{"type":"string","description":"Internal data type identifier returned by the API serializer.","example":"app.http.api.template_collection.data.template_collection_data"}},"required":["id","title"]}},"components/schemas/ResponseMeta":{"id":"components/schemas/ResponseMeta","kind":"json-schema","title":"ResponseMeta","data":{"type":"object","properties":{"status":{"type":"object","properties":{"code":{"type":"integer","example":200},"text":{"type":"string","example":"OK"}},"required":["code","text"]},"pagination":{"type":"object","properties":{"items":{"type":"integer","minimum":0,"description":"Number of items in the current page.","example":15},"total":{"type":"integer","minimum":0,"description":"Total number of items across all pages.","example":51},"has_pages":{"type":"boolean","description":"Whether there are multiple pages.","example":true},"is_first":{"type":"boolean","description":"Whether the current page is the first page.","example":true},"pointer":{"type":"object","description":"Page navigation pointers.","properties":{"previous":{"oneOf":[{"type":"integer"},{"type":"null"}],"description":"Previous page number, or null if on the first page.","example":null},"current":{"type":"integer","minimum":1,"description":"Current page number.","example":1},"next":{"oneOf":[{"type":"integer"},{"type":"null"}],"description":"Next page number, or null if on the last page.","example":2}},"required":["previous","current","next"]}},"required":["items","total","has_pages","is_first","pointer"]}},"required":["status","pagination"]}},"components/schemas/Api.Workspace.Data.WorkspaceData.WorkspaceData":{"id":"components/schemas/Api.Workspace.Data.WorkspaceData.WorkspaceData","kind":"json-schema","title":"Api.Workspace.Data.WorkspaceData.WorkspaceData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"}},"components/schemas/App.Data.Template.TemplateData.TemplateData":{"id":"components/schemas/App.Data.Template.TemplateData.TemplateData","kind":"json-schema","title":"App.Data.Template.TemplateData.TemplateData","data":{"additionalProperties":false,"properties":{"collections":{"items":{"$ref":"#/components/schemas/App.Data.Template.TemplateCollectionData.TemplateCollectionData"},"type":"array"},"created_at":{"type":"string"},"default_document_name":{"additionalProperties":{"type":"string"},"type":"object"},"description":{"additionalProperties":{"type":"string"},"type":"object"},"id":{"type":"string"},"jurisdictions":{"items":{"$ref":"#/components/schemas/App.Data.Template.JurisdictionData.JurisdictionData"},"type":"array"},"languages":{"items":{"$ref":"#/components/schemas/App.Data.Template.LanguageData.LanguageData"},"type":"array"},"short_description":{"additionalProperties":{"type":"string"},"type":"object"},"title":{"additionalProperties":{"type":"string"},"type":"object"},"updated_at":{"type":"string"}},"required":["id","title","short_description","description","default_document_name","created_at","updated_at"],"type":"object"}},"components/schemas/App.Data.Template.TemplateCollectionData.TemplateCollectionData":{"id":"components/schemas/App.Data.Template.TemplateCollectionData.TemplateCollectionData","kind":"json-schema","title":"App.Data.Template.TemplateCollectionData.TemplateCollectionData","data":{"additionalProperties":false,"properties":{"created_at":{"type":"string"},"id":{"type":"string"},"templates":{"items":{"$ref":"#/components/schemas/App.Data.Template.TemplateData.TemplateData"},"type":"array"},"title":{"additionalProperties":{"type":"string"},"type":"object"},"updated_at":{"type":"string"}},"required":["id","title","created_at","updated_at"],"type":"object"}},"components/schemas/App.Data.Template.JurisdictionData.JurisdictionData":{"id":"components/schemas/App.Data.Template.JurisdictionData.JurisdictionData","kind":"json-schema","title":"App.Data.Template.JurisdictionData.JurisdictionData","data":{"additionalProperties":false,"properties":{"code":{"type":"string"},"id":{"type":"string"}},"required":["id","code"],"type":"object"}},"components/schemas/App.Data.Template.LanguageData.LanguageData":{"id":"components/schemas/App.Data.Template.LanguageData.LanguageData","kind":"json-schema","title":"App.Data.Template.LanguageData.LanguageData","data":{"additionalProperties":false,"properties":{"code":{"type":"string"},"id":{"type":"string"}},"required":["id","code"],"type":"object"}},"components/schemas/App.Enums.HttpMethod":{"id":"components/schemas/App.Enums.HttpMethod","kind":"json-schema","title":"App.Enums.HttpMethod","data":{"const":"GET","type":"string"}},"components/schemas/App.Payload.Primitives.HandlerPayload.HandlerPayload":{"id":"components/schemas/App.Payload.Primitives.HandlerPayload.HandlerPayload","kind":"json-schema","title":"App.Payload.Primitives.HandlerPayload.HandlerPayload","data":{"additionalProperties":false,"properties":{"method":{"$ref":"#/components/schemas/App.Enums.HttpMethod"},"url":{"type":"string"}},"required":["url","method"],"type":"object"}},"components/schemas/App.Payload.Primitives.HandlersPayload.HandlersPayload":{"id":"components/schemas/App.Payload.Primitives.HandlersPayload.HandlersPayload","kind":"json-schema","title":"App.Payload.Primitives.HandlersPayload.HandlersPayload","data":{"additionalProperties":false,"properties":{"cancel_handler":{"$ref":"#/components/schemas/App.Payload.Primitives.HandlerPayload.HandlerPayload"},"delete_handler":{"$ref":"#/components/schemas/App.Payload.Primitives.HandlerPayload.HandlerPayload"},"error_handler":{"$ref":"#/components/schemas/App.Payload.Primitives.HandlerPayload.HandlerPayload"},"success_handler":{"$ref":"#/components/schemas/App.Payload.Primitives.HandlerPayload.HandlerPayload"}},"required":["success_handler","cancel_handler","delete_handler","error_handler"],"type":"object"}},"components/schemas/App.Enums.UiLanguage":{"id":"components/schemas/App.Enums.UiLanguage","kind":"json-schema","title":"App.Enums.UiLanguage","data":{"enum":["en-GB","fi","de","pl","sv"],"type":"string"}},"components/schemas/Api.BrowserSession.Payload.CreateBrowserSessionPayload.CreateBrowserSessionPayload":{"id":"components/schemas/Api.BrowserSession.Payload.CreateBrowserSessionPayload.CreateBrowserSessionPayload","kind":"json-schema","title":"Api.BrowserSession.Payload.CreateBrowserSessionPayload.CreateBrowserSessionPayload","data":{"additionalProperties":false,"properties":{"handlers":{"$ref":"#/components/schemas/App.Payload.Primitives.HandlersPayload.HandlersPayload"},"ui_language":{"$ref":"#/components/schemas/App.Enums.UiLanguage"}},"required":["handlers"],"type":"object"}},"components/schemas/Api.BrowserSession.Data.BrowserSessionCreatedData.BrowserSessionCreatedData":{"id":"components/schemas/Api.BrowserSession.Data.BrowserSessionCreatedData.BrowserSessionCreatedData","kind":"json-schema","title":"Api.BrowserSession.Data.BrowserSessionCreatedData.BrowserSessionCreatedData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"url":{"type":"string"}},"required":["id","url"],"type":"object"}},"components/schemas/App.Data.BrowserSession.BrowserSessionStateData.BrowserSessionStateData":{"id":"components/schemas/App.Data.BrowserSession.BrowserSessionStateData.BrowserSessionStateData","kind":"json-schema","title":"App.Data.BrowserSession.BrowserSessionStateData.BrowserSessionStateData","data":{"additionalProperties":false,"properties":{"document_name":{"type":"string"},"languages":{"items":{"type":"string"},"type":"array"},"template_id":{"type":"string"}},"required":["template_id","languages","document_name"],"type":"object"}},"components/schemas/App.Enums.BrowserSessionStatus":{"id":"components/schemas/App.Enums.BrowserSessionStatus","kind":"json-schema","title":"App.Enums.BrowserSessionStatus","data":{"enum":["pending","completed","deleted"],"type":"string"}},"components/schemas/Api.BrowserSession.Data.BrowserSessionData.BrowserSessionData":{"id":"components/schemas/Api.BrowserSession.Data.BrowserSessionData.BrowserSessionData","kind":"json-schema","title":"Api.BrowserSession.Data.BrowserSessionData.BrowserSessionData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"state":{"anyOf":[{"$ref":"#/components/schemas/App.Data.BrowserSession.BrowserSessionStateData.BrowserSessionStateData"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/App.Enums.BrowserSessionStatus"}},"required":["id","status","state"],"type":"object"}},"components/schemas/Api.BuilderSession.Payload.ContractPayload.ContractPayload":{"id":"components/schemas/Api.BuilderSession.Payload.ContractPayload.ContractPayload","kind":"json-schema","title":"Api.BuilderSession.Payload.ContractPayload.ContractPayload","data":{"additionalProperties":false,"properties":{"document_name":{"type":"string"},"languages":{"items":{"type":"string"},"type":"array"},"template_id":{"type":"string"}},"required":["template_id","document_name","languages"],"type":"object"}},"components/schemas/App.Payload.Primitives.ParticipantPayload.ParticipantPayload":{"id":"components/schemas/App.Payload.Primitives.ParticipantPayload.ParticipantPayload","kind":"json-schema","title":"App.Payload.Primitives.ParticipantPayload.ParticipantPayload","data":{"additionalProperties":false,"properties":{"display_name":{"type":"string"},"email":{"type":"string"},"external_id":{"type":"string"}},"required":[],"type":"object"}},"components/schemas/App.Data.Primitives.ParticipantData.ParticipantData":{"id":"components/schemas/App.Data.Primitives.ParticipantData.ParticipantData","kind":"json-schema","title":"App.Data.Primitives.ParticipantData.ParticipantData","data":{"additionalProperties":false,"properties":{"display_name":{"type":["string","null"]},"email":{"type":["string","null"]},"external_id":{"type":["string","null"]},"_data_type":{"type":["string","null"]},"id":{"type":"string"},"token":{"type":"string"}},"required":["id","email","display_name","external_id"],"type":"object"}},"components/schemas/Api.BuilderSession.Data.BuilderSessionCreatedData.BuilderSessionCreatedData":{"id":"components/schemas/Api.BuilderSession.Data.BuilderSessionCreatedData.BuilderSessionCreatedData","kind":"json-schema","title":"Api.BuilderSession.Data.BuilderSessionCreatedData.BuilderSessionCreatedData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"participant":{"$ref":"#/components/schemas/App.Data.Primitives.ParticipantData.ParticipantData"},"url":{"type":"string"}},"required":["id","url","participant"],"type":"object"}},"components/schemas/App.Enums.BuilderSessionStatus":{"id":"components/schemas/App.Enums.BuilderSessionStatus","kind":"json-schema","title":"App.Enums.BuilderSessionStatus","data":{"enum":["pending","completed","deleted"],"type":"string"}},"components/schemas/Api.BuilderSession.Participant.Data.ParticipantAuthenticatedData.ParticipantAuthenticatedData":{"id":"components/schemas/Api.BuilderSession.Participant.Data.ParticipantAuthenticatedData.ParticipantAuthenticatedData","kind":"json-schema","title":"Api.BuilderSession.Participant.Data.ParticipantAuthenticatedData.ParticipantAuthenticatedData","data":{"additionalProperties":false,"properties":{"id":{"type":"string"},"participant":{"$ref":"#/components/schemas/App.Data.Primitives.ParticipantData.ParticipantData"},"url":{"type":"string"}},"required":["id","url","participant"],"type":"object"}},"schema_0":{"kind":"json-schema","data":{"type":"string","enum":["application/json"]},"id":"schema_0"},"schema_1":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Api.Workspace.Data.WorkspaceData.WorkspaceData"}}},"id":"schema_1"},"schema_2":{"kind":"json-schema","data":{"type":"integer","minimum":1,"maximum":100,"default":15,"example":20},"id":"schema_2"},"schema_3":{"kind":"json-schema","data":{"type":"integer","minimum":1,"default":1,"example":1},"id":"schema_3"},"schema_4":{"kind":"json-schema","data":{"type":"string","maxLength":200},"id":"schema_4"},"schema_5":{"kind":"json-schema","data":{"type":"string","format":"uuid"},"id":"schema_5"},"schema_6":{"kind":"json-schema","data":{"type":"string","enum":["en","en-US","en-GB","en-AU","en-CA","en-IN","en-NZ","en-ZA","es","pt","de","fr","tr","it","pl","ro","nl","sv","hu","cs","el","fi","no","da","sk","bg","hr","sr","lt","lv","sl","et","is"]},"id":"schema_6"},"schema_7":{"kind":"json-schema","data":{"type":"string"},"id":"schema_7"},"schema_8":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/App.Data.Template.TemplateData.TemplateData"}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}},"id":"schema_8"},"schema_9":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TemplateCollectionData"}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}},"id":"schema_9"},"schema_10":{"kind":"json-schema","data":{"type":"string","format":"uuid","example":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a"},"id":"schema_10"},"schema_11":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/App.Data.Template.TemplateData.TemplateData"}}},"id":"schema_11"},"schema_12":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Api.BrowserSession.Data.BrowserSessionCreatedData.BrowserSessionCreatedData"}}},"id":"schema_12"},"schema_13":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Api.BrowserSession.Data.BrowserSessionData.BrowserSessionData"}}},"id":"schema_13"},"schema_14":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Api.BuilderSession.Data.BuilderSessionCreatedData.BuilderSessionCreatedData"}}},"id":"schema_14"},"schema_15":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/BuilderSessionData"}}},"id":"schema_15"},"schema_16":{"kind":"json-schema","data":{"type":"string","format":"uuid","example":"123e4567-e89b-12d3-a456-426614174000"},"id":"schema_16"},"schema_17":{"kind":"json-schema","data":{"type":"object","required":["operations"],"properties":{"operations":{"type":"array","maxItems":500,"description":"JSON Patch operations, applied in the order they appear.","items":{"type":"object","required":["op","path"],"properties":{"op":{"type":"string","enum":["replace","remove","add"],"example":"replace"},"path":{"type":"string","example":"/document_name"},"value":{"example":"My document"}}}},"allow_partial":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", operations that succeed are saved even if others fail, and the response lists the failed operations under "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.failed_operations"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (the default), the patch is all-or-nothing."},"children":[]}]}]}],"example":true}}},"id":"schema_17"},"schema_18":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"null","description":"Always null for error responses."},"meta":{"type":"object","properties":{"status":{"type":"object","properties":{"code":{"type":"integer","example":409},"text":{"type":"string","example":"Conflict"}},"required":["code","text"]},"error":{"type":"object","properties":{"text":{"type":"string","example":"Only a pending session can be finalized"}},"required":["text"]}},"required":["status","error"]}},"required":["data","meta"]},"id":"schema_18"},"schema_19":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"null","description":"Always null for error responses."},"meta":{"type":"object","properties":{"status":{"type":"object","properties":{"code":{"type":"integer","example":409},"text":{"type":"string","example":"Conflict"}},"required":["code","text"]},"error":{"type":"object","properties":{"text":{"type":"string","example":"Only a completed session contract can be unfinalized"}},"required":["text"]}},"required":["status","error"]}},"required":["data","meta"]},"id":"schema_19"},"schema_20":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Api.BuilderSession.Participant.Data.ParticipantAuthenticatedData.ParticipantAuthenticatedData"}}},"id":"schema_20"},"schema_21":{"kind":"json-schema","data":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CreateSigningSessionPayload"},"files":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Binary file uploads. Each uploaded file corresponds by position to an entry in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.files"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that does not have a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"string","format":"binary"}}}},"id":"schema_21"},"schema_22":{"kind":"json-schema","data":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd"},"id":"schema_22"},"schema_23":{"kind":"json-schema","data":{"type":"object","additionalProperties":false,"required":["expires_at"],"properties":{"expires_at":{"$ref":"#/components/schemas/SigningSessionExpirationTime"}}},"id":"schema_23"},"schema_24":{"kind":"json-schema","data":{"type":"string","format":"binary"},"id":"schema_24"},"schema_25":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/SigningSuccessResponse"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SigningWebhookCall"}}}}]},"id":"schema_25"},"schema_26":{"kind":"json-schema","data":{"type":"integer","minimum":1,"maximum":100,"default":100},"id":"schema_26"},"schema_27":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/SigningSuccessResponse"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SigningAuditRecord"}}}}]},"id":"schema_27"},"schema_28":{"kind":"json-schema","data":{"type":"object","required":["data","file"],"properties":{"data":{"$ref":"#/components/schemas/SigningSessionFileUploadData"},"file":{"type":"string","format":"binary","description":"The file content to upload."}}},"id":"schema_28"},"schema_29":{"kind":"json-schema","data":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88211"},"id":"schema_29"},"schema_30":{"kind":"json-schema","data":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88311"},"id":"schema_30"},"schema_31":{"kind":"json-schema","data":{"type":"string","format":"uuid","example":"0196ae5b-2e9d-729f-aba5-fa4db6f88401"},"id":"schema_31"}},"exampleStore":{"paths/~1api~1workspaces~1current/get/responses/200/content/application~1json/example":{"value":{"data":{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","name":"Acme Inc."}},"id":"paths/~1api~1workspaces~1current/get/responses/200/content/application~1json/example"},"paths/~1api~1templates/get/responses/200/content/application~1json/example":{"value":{"data":[{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","title":{"_type":"translatable","en-GB":"Employment Agreement"},"description":{"_type":"translatable","en-GB":"Description"},"short_description":{"_type":"translatable","en-GB":"Short description"},"default_document_name":{"_type":"translatable","en-GB":"Employment Agreement"},"collections":[{"id":"01965c7e-dc1e-7292-8199-8184041c1204","title":{"de":"Arbeitsrecht","fi":"Työsuhde ja HR","pl":"Zatrudnienie i HR","sv":"Anställningsförhållande och HR","_type":"translatable","en-GB":"Employment and HR"},"created_at":"2026-03-02T11:37:09Z","updated_at":"2026-04-20T12:38:43Z"},{"id":"0198553a-20cc-7344-bbf9-a75dde9152dd","title":{"de":"Gründung","fi":"Yrityksen perustaminen","pl":"Zakładanie przedsiębiorstwa","sv":"Starta ett företag","_type":"translatable","en-GB":"Starting a company"},"created_at":"2026-03-02T11:37:10Z","updated_at":"2026-04-20T12:38:37Z"}],"created_at":"2025-03-22T14:30:00Z","updated_at":"2025-03-22T14:30:00Z","languages":[{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","code":"en-GB"}],"jurisdictions":[{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","code":"FI"}]}],"meta":{"status":{"code":200,"text":"OK"},"pagination":{"items":1,"total":30,"has_pages":true,"is_first":true,"pointer":{"previous":null,"current":1,"next":2}}}},"id":"paths/~1api~1templates/get/responses/200/content/application~1json/example"},"paths/~1api~1template-collections/get/responses/200/content/application~1json/example":{"value":{"data":[{"id":"01965c7e-dc1e-7292-8199-8184041c1204","title":{"de":"Arbeitsrecht","fi":"Työsuhde ja HR","pl":"Zatrudnienie i HR","sv":"Anställningsförhållande och HR","_type":"translatable","en-GB":"Employment and HR"},"_data_type":"app.http.api.template_collection.data.template_collection_data"},{"id":"0198553c-9fdc-7299-a901-64896be29f30","title":{"de":"Finanzierung","fi":"Rahoitus, tilinpäätös ja varojenjako","pl":"Finanse przedsiębiorstw","sv":"Finansiering, bokslut och betalningar","_type":"translatable","en-GB":"Corporate finance"},"_data_type":"app.http.api.template_collection.data.template_collection_data"}],"meta":{"status":{"code":200,"text":"OK"},"pagination":{"items":2,"total":12,"has_pages":true,"is_first":true,"pointer":{"previous":null,"current":1,"next":2}}}},"id":"paths/~1api~1template-collections/get/responses/200/content/application~1json/example"},"paths/~1api~1templates~1{template_id}/get/responses/200/content/application~1json/example":{"value":{"data":{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","title":{"_type":"translatable","en-GB":"Employment Agreement"},"description":{"_type":"translatable","en-GB":"Description"},"short_description":{"_type":"translatable","en-GB":"Short description"},"default_document_name":{"_type":"translatable","en-GB":"Employment Agreement"},"collections":[{"id":"01965c7e-dc1e-7292-8199-8184041c1204","title":{"de":"Arbeitsrecht","fi":"Työsuhde ja HR","pl":"Zatrudnienie i HR","sv":"Anställningsförhållande och HR","_type":"translatable","en-GB":"Employment and HR"},"created_at":"2026-03-02T11:37:09Z","updated_at":"2026-04-20T12:38:43Z"},{"id":"0198553a-20cc-7344-bbf9-a75dde9152dd","title":{"de":"Gründung","fi":"Yrityksen perustaminen","pl":"Zakładanie przedsiębiorstwa","sv":"Starta ett företag","_type":"translatable","en-GB":"Starting a company"},"created_at":"2026-03-02T11:37:10Z","updated_at":"2026-04-20T12:38:37Z"}],"created_at":"2025-03-22T14:30:00Z","updated_at":"2025-03-22T14:30:00Z","languages":[{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","code":"en-GB"}],"jurisdictions":[{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","code":"FI"}]}},"id":"paths/~1api~1templates~1{template_id}/get/responses/200/content/application~1json/example"},"paths/~1api~1templates~1{template_id}/get/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1api~1templates~1{template_id}/get/responses/404/content/application~1json/example"},"paths/~1api~1browser~1sessions/post/requestBody/content/application~1json/example":{"value":{"ui_language":"en-GB","handlers":{"success_handler":{"url":"https://example.com","method":"GET"},"error_handler":{"url":"https://example.com","method":"GET"},"delete_handler":{"url":"https://example.com","method":"GET"},"cancel_handler":{"url":"https://example.com","method":"GET"}}},"id":"paths/~1api~1browser~1sessions/post/requestBody/content/application~1json/example"},"paths/~1api~1browser~1sessions/post/responses/201/content/application~1json/example":{"value":{"data":{"id":"0195c6eb-99ae-73c1-94f0-1763b872735d","url":"https://app.builder.docue.com/browser-session/0195c6eb-99ae-73c1-94f0-1763b872735d#pREXDkBmZSOnl29EzmoICcfx9S19ix6u"}},"id":"paths/~1api~1browser~1sessions/post/responses/201/content/application~1json/example"},"paths/~1api~1browser~1sessions~1{session_id}/get/responses/200/content/application~1json/example":{"value":{"data":{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","status":"completed","state":{"template_id":"0195c6eb-99ae-73c1-cc3a-1763b8743333d","languages":["en-GB"],"document_name":"Employment Agreement"}}},"id":"paths/~1api~1browser~1sessions~1{session_id}/get/responses/200/content/application~1json/example"},"paths/~1api~1browser~1sessions~1{session_id}/get/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1api~1browser~1sessions~1{session_id}/get/responses/404/content/application~1json/example"},"paths/~1api~1browser~1sessions~1{session_id}/delete/responses/200/content/application~1json/example":{"value":{"data":{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","status":"deleted","state":null}},"id":"paths/~1api~1browser~1sessions~1{session_id}/delete/responses/200/content/application~1json/example"},"paths/~1api~1browser~1sessions~1{session_id}/delete/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1api~1browser~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"},"paths/~1api~1builder~1sessions/post/requestBody/content/application~1json/example":{"value":{"contract":{"template_id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","document_name":"Employment agreement","languages":["en-GB"]},"participant":{"email":"john.doe@example.org","display_name":"John Doe"},"ui_language":"en-GB","handlers":{"success_handler":{"url":"https://example.com","method":"GET"},"error_handler":{"url":"https://example.com","method":"GET"},"delete_handler":{"url":"https://example.com","method":"GET"},"cancel_handler":{"url":"https://example.com","method":"GET"}},"finalization":{"confirmation_enabled":true,"confirmation_text":"<strong>Please review carefully.</strong> This action cannot be undone."}},"id":"paths/~1api~1builder~1sessions/post/requestBody/content/application~1json/example"},"paths/~1api~1builder~1sessions/post/responses/201/content/application~1json/example":{"value":{"data":{"id":"0195c6eb-99ae-73c1-94f0-1763b872735d","url":"https://app.builder.docue.com/browser-session/0195c6eb-99ae-73c1-94f0-1763b872735d#pREXDkBmZSOnl29EzmoICcfx9S19ix6u","participant":{"id":"0195c6eb-99ae-73c1-94f0-1763b872735d","display_name":null,"external_id":null,"email":null}}},"id":"paths/~1api~1builder~1sessions/post/responses/201/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}/get/responses/200/content/application~1json/example":{"value":{"data":{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","status":"completed","trial":null,"finalization":null,"participants":[{"id":"123e4567-e89b-12d3-a456-426614174000","display_name":null,"email":null,"external_id":null}]}},"id":"paths/~1api~1builder~1sessions~1{session_id}/get/responses/200/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}/get/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}/get/responses/404/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}/patch/requestBody/content/application~1json/example":{"value":{"trial":{"cta_url":"https://example.com/trial","heading_text":"<strong>Free trial</strong> - Upgrade to unlock full preview, downloads, and e-signing.","heading_cta_text":"Explore plans","preview_text":"Unlock full preview","finalize_title":"Finish and use your document","finalize_content":"<h3>Your document is ready.</h3><p>Upgrade to:</p><ul><li>View the full document</li><li>Download it as a PDF</li><li>Send it for signing</li></ul>","finalize_cta_text":"Explore plans"},"finalization":{"confirmation_enabled":true,"confirmation_text":"<strong>Please review carefully.</strong> This action cannot be undone."}},"id":"paths/~1api~1builder~1sessions~1{session_id}/patch/requestBody/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}/patch/responses/200/content/application~1json/example":{"value":{"data":{"id":"7f3f5f62-2c69-7d4e-8a3d-9c0f0e2c5f3a","status":"pending","trial":{"cta_url":"https://example.com/trial","heading_text":"<strong>Free trial</strong> - Upgrade to unlock full preview, downloads, and e-signing.","heading_cta_text":"Explore plans","preview_text":"Unlock full preview","finalize_title":"Finish and use your document","finalize_content":"<h3>Your document is ready.</h3><p>Upgrade to:</p><ul><li>View the full document</li><li>Download it as a PDF</li><li>Send it for signing</li></ul>","finalize_cta_text":"Explore plans"},"finalization":{"confirmation_enabled":true,"confirmation_text":"<strong>Please review carefully.</strong> This action cannot be undone."},"participants":[{"id":"123e4567-e89b-12d3-a456-426614174000","display_name":"Jane Doe","email":"jane.doe@example.org","external_id":"user-123"}]}},"id":"paths/~1api~1builder~1sessions~1{session_id}/patch/responses/200/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}/patch/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}/patch/responses/404/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}/patch/responses/409/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":409,"text":"Conflict"},"error":{"text":"Only a pending session can be patched"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}/patch/responses/409/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}/delete/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}/delete/responses/404/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1contract/get/responses/200/content/application~1json/example":{"value":{"data":{"state":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","status":"draft","document_name":"Testing document","jurisdiction":"FI","languages":["en-GB"],"value":{"_type":"value","_id":"0196ae5b-2e9d-729f-aba5-fca3d9d646a4","basic":{"_type":"value","_id":"0196ae5b-2e9d-729f-aba6-03235f09a720","title":{"_type":"translatable","en-GB":"Non-Disclosure Agreement"}},"parties":[{"_type":"value","_id":"0196ae5b-2e9d-729f-aba6-07fd964cae09","type":"company","company_name":"Docue","company_id":"1212","first_name":"John","last_name":"Doe","job_title":""},{"_type":"value","_id":"0196ae5c-3d2e-7005-9c0d-746605183d92","type":"person","company_name":"","company_id":"","first_name":"Richard","last_name":"Roe","job_title":""}],"place_and_date":{"_type":"value","_id":"0196ae5b-2e9e-706c-aa37-3327550c36ee","place":"Helsinki","date":"2025-05-01"}},"sections":[{"_type":"contract-section","id":"0196623c-5d00-7ff8-9528-5187dc2fe5d9","title":{"_type":"translatable","en-GB":"Basic information"},"name":"","is_included":true,"type":"template","template_section_id":"0196623c-5d00-7ff8-9528-5187dc2fe5d9","content":null},{"_type":"contract-section","id":"0196ae74-b492-700e-a824-9899cb125a3b","title":{"_type":"translatable","en-GB":"Background"},"name":"","is_included":true,"type":"custom","content":{"_type":"translatable","en-GB":"<p>Background for this contract is to just test the builder.</p>"}},{"_type":"contract-section","id":"0196623c-8461-7ff8-9528-740c187c94cc","title":{"_type":"translatable","en-GB":"Contracting parties"},"name":"","is_included":true,"type":"template","template_section_id":"0196623c-8461-7ff8-9528-740c187c94cc","content":null},{"_type":"contract-section","id":"01966243-fe05-7ff8-9529-572ead0c674b","title":{"_type":"translatable","en-GB":"Place and date"},"name":"","is_included":true,"type":"template","template_section_id":"01966243-fe05-7ff8-9529-572ead0c674b","content":null}],"appearance":{"logo":{"enabled":false,"content":null,"scale":50},"footer":{"enabled":false,"content":""},"heading1":{"family":"arial","color":"#000000","size":"20","weight":"bold","alignment":"left","transform":"none"},"heading2":{"family":"arial","color":"#000000","size":"13","weight":"bold","alignment":"left","transform":"none"},"heading3":{"family":"arial","color":"#000000","size":"12","weight":"bold","alignment":"left","transform":"none"},"heading4":{"family":"arial","color":"#000000","size":"11","weight":"bold","alignment":"left","transform":"none"},"heading5":{"family":"arial","color":"#000000","size":"11","weight":"regular","alignment":"left","transform":"none"},"heading6":{"family":"arial","color":"#000000","size":"11","weight":"regular","alignment":"left","transform":"none"},"paragraph":{"family":"arial","color":"#000000","size":"11","weight":"regular","alignment":"justify","transform":"none"},"table":{"family":"arial","size":"11","color":"#000000","bgColor":"#ffffff","headerBgColor":"#e7e5e4","headerColor":"#000000","borderColorEnabled":true,"borderColor":"#ffffff","alternatingRowBgColorEnabled":true,"alternatingRowBgColor":"#fafaf9"}}},"signees":[{"_type":"signature","id":"0196ae5b-2e9d-729f-aba6-07fd964cae09","first_name":"John","last_name":"Doe","job_title":"","fieldset_name":"parties","page":1,"x":0.15219702338766833,"y":0.3558135326624073,"width":0.31498543192377354,"height":0.10690274355869211},{"_type":"signature","id":"0196ae5c-3d2e-7005-9c0d-746605183d92","first_name":"Richard","last_name":"Roe","job_title":"","fieldset_name":"parties","page":1,"x":0.5040357508465233,"y":0.3558135326624073,"width":0.31498543192377354,"height":0.10690274355869211}]}},"id":"paths/~1api~1builder~1sessions~1{session_id}~1contract/get/responses/200/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/allOrNothing":{"value":{"operations":[{"op":"replace","path":"/document_name","value":"Employment agreement, John Doe"}]},"key":"allOrNothing","summary":"Default all-or-nothing patch","id":"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/allOrNothing"},"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/partial":{"value":{"allow_partial":true,"operations":[{"op":"replace","path":"/document_name","value":"Employment agreement, John Doe"},{"op":"replace","path":"/value/basic/title","value":"Employment agreement"}]},"key":"partial","summary":"Partial success allowed","id":"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/requestBody/content/application~1json/examples/partial"},"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialSomeFailed":{"value":{"data":{"state":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","status":"draft","document_name":"Employment agreement, John Doe","jurisdiction":"FI","languages":["en-GB"],"value":{"_type":"value","_id":"0196ae5b-2e9d-729f-aba5-fca3d9d646a4","basic":{"_type":"value","_id":"0196ae5b-2e9d-729f-aba6-03235f09a720","title":{"_type":"translatable","en-GB":"Non-Disclosure Agreement"}}},"sections":[],"appearance":{}},"signees":[]},"meta":{"status":{"code":200,"text":"OK"},"failed_operations":[{"index":1,"path":"/value/basic/title","error":{"code":"invalid_operation","message":"Operation \"replace\" at \"/value/basic/title\" failed: invalid value","details":{"value":"Invalid input: expected object, received string"}}}]}},"key":"partialSomeFailed","summary":"Partial success allowed and some operations failed","id":"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialSomeFailed"},"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialAllFailed":{"value":{"data":{"state":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","status":"draft","document_name":"Non-Disclosure Agreement","jurisdiction":"FI","languages":["en-GB"],"value":{"_type":"value","_id":"0196ae5b-2e9d-729f-aba5-fca3d9d646a4","basic":{"_type":"value","_id":"0196ae5b-2e9d-729f-aba6-03235f09a720","title":{"_type":"translatable","en-GB":"Non-Disclosure Agreement"}}},"sections":[],"appearance":{}},"signees":[]},"meta":{"status":{"code":200,"text":"OK"},"failed_operations":[{"index":0,"path":"/id","error":{"code":"invalid_operation","message":"Operation \"replace\" at \"/id\" failed: Operations at the specified path are not permitted","details":[]}},{"index":1,"path":"/value/basic/title","error":{"code":"invalid_operation","message":"Operation \"replace\" at \"/value/basic/title\" failed: invalid value","details":{"value":"Invalid input: expected object, received string"}}}]}},"key":"partialAllFailed","summary":"Partial success allowed and every operation failed","id":"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/partialAllFailed"},"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/fullState":{"value":{"data":{"state":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","status":"draft","document_name":"Employment agreement, John Doe","jurisdiction":"FI","languages":["en-GB"],"value":{"_type":"value","_id":"0196ae5b-2e9d-729f-aba5-fca3d9d646a4","basic":{"_type":"value","_id":"0196ae5b-2e9d-729f-aba6-03235f09a720","title":{"_type":"translatable","en-GB":"Non-Disclosure Agreement"}},"parties":[{"_type":"value","_id":"0196ae5b-2e9d-729f-aba6-07fd964cae09","type":"company","company_name":"Docue","company_id":"1212","first_name":"John","last_name":"Doe","job_title":""},{"_type":"value","_id":"0196ae5c-3d2e-7005-9c0d-746605183d92","type":"person","company_name":"","company_id":"","first_name":"Richard","last_name":"Roe","job_title":""}],"place_and_date":{"_type":"value","_id":"0196ae5b-2e9e-706c-aa37-3327550c36ee","place":"Helsinki","date":"2025-05-01"}},"sections":[{"_type":"contract-section","id":"0196623c-5d00-7ff8-9528-5187dc2fe5d9","title":{"_type":"translatable","en-GB":"Basic information"},"name":"","is_included":true,"type":"template","template_section_id":"0196623c-5d00-7ff8-9528-5187dc2fe5d9","content":null},{"_type":"contract-section","id":"0196ae74-b492-700e-a824-9899cb125a3b","title":{"_type":"translatable","en-GB":"Background"},"name":"","is_included":true,"type":"custom","content":{"_type":"translatable","en-GB":"<p>Background for this contract is to just test the builder.</p>"}},{"_type":"contract-section","id":"0196623c-8461-7ff8-9528-740c187c94cc","title":{"_type":"translatable","en-GB":"Contracting parties"},"name":"","is_included":true,"type":"template","template_section_id":"0196623c-8461-7ff8-9528-740c187c94cc","content":null},{"_type":"contract-section","id":"01966243-fe05-7ff8-9529-572ead0c674b","title":{"_type":"translatable","en-GB":"Place and date"},"name":"","is_included":true,"type":"template","template_section_id":"01966243-fe05-7ff8-9529-572ead0c674b","content":null}],"appearance":{"logo":{"enabled":false,"content":null,"scale":50},"footer":{"enabled":false,"content":""},"heading1":{"family":"arial","color":"#000000","size":"20","weight":"bold","alignment":"left","transform":"none"},"heading2":{"family":"arial","color":"#000000","size":"13","weight":"bold","alignment":"left","transform":"none"},"heading3":{"family":"arial","color":"#000000","size":"12","weight":"bold","alignment":"left","transform":"none"},"heading4":{"family":"arial","color":"#000000","size":"11","weight":"bold","alignment":"left","transform":"none"},"heading5":{"family":"arial","color":"#000000","size":"11","weight":"regular","alignment":"left","transform":"none"},"heading6":{"family":"arial","color":"#000000","size":"11","weight":"regular","alignment":"left","transform":"none"},"paragraph":{"family":"arial","color":"#000000","size":"11","weight":"regular","alignment":"justify","transform":"none"},"table":{"family":"arial","size":"11","color":"#000000","bgColor":"#ffffff","headerBgColor":"#e7e5e4","headerColor":"#000000","borderColorEnabled":true,"borderColor":"#ffffff","alternatingRowBgColorEnabled":true,"alternatingRowBgColor":"#fafaf9"}}},"signees":[{"_type":"signature","id":"0196ae5b-2e9d-729f-aba6-07fd964cae09","first_name":"John","last_name":"Doe","job_title":"","fieldset_name":"parties","page":1,"x":0.15219702338766833,"y":0.3558135326624073,"width":0.31498543192377354,"height":0.10690274355869211},{"_type":"signature","id":"0196ae5c-3d2e-7005-9c0d-746605183d92","first_name":"Richard","last_name":"Roe","job_title":"","fieldset_name":"parties","page":1,"x":0.5040357508465233,"y":0.3558135326624073,"width":0.31498543192377354,"height":0.10690274355869211}]},"meta":{"status":{"code":200,"text":"OK"},"failed_operations":[]}},"key":"fullState","summary":"Full contract state","id":"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/200/content/application~1json/examples/fullState"},"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/404/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/allOrNothingRejected":{"value":{"data":null,"meta":{"status":{"code":422,"text":"Unprocessable Content"},"error":{"text":"Operation \"replace\" at \"/value/basic/title\" failed: invalid value","details":{"value":"Invalid input: expected object, received string"}}}},"key":"allOrNothingRejected","summary":"Operation failed without partial success","id":"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/allOrNothingRejected"},"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/malformedRequest":{"value":{"data":null,"meta":{"status":{"code":422,"text":"Unprocessable Content"},"error":{"text":"The allow partial field must be true or false.","details":{"allow_partial":["The allow partial field must be true or false."]}}}},"key":"malformedRequest","summary":"Malformed request","id":"paths/~1api~1builder~1sessions~1{session_id}~1contract/patch/responses/422/content/application~1json/examples/malformedRequest"},"paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post/responses/409/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":409,"text":"Conflict"},"error":{"text":"Only a pending session can be finalized"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}~1contract~1finalize/post/responses/409/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post/responses/409/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":409,"text":"Conflict"},"error":{"text":"Only a completed session contract can be unfinalized"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}~1contract~1unfinalize/post/responses/409/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1html/get/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}~1html/get/responses/404/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example":{"value":{"ui_language":"en-GB","participant":{"email":"john.doe@example.org","display_name":"John Doe","external_id":"user-123"}},"id":"paths/~1api~1builder~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example":{"value":{"data":{"id":"0195c6eb-99ae-73c1-94f0-1763b872735d","url":"https://app.builder.docue.com/builder-session/0195c6eb-99ae-73c1-94f0-1763b872735d#pREXDkBmZSOnl29EzmoICcfx9S19ix6u","participant":{"id":"0195d42e-d7d5-7f05-8eaf-af1a9c569230","display_name":"John Doe","external_id":"user-123","email":"john.doe@example.org"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1api~1builder~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/requestBody/content/application~1json/example":{"value":{"ui_language":"en-GB"},"id":"paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/requestBody/content/application~1json/example"},"paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/responses/201/content/application~1json/example":{"value":{"data":{"id":"0195c6eb-99ae-73c1-94f0-1763b872735d","url":"https://app.builder.docue.com/browser-session/0195c6eb-99ae-73c1-94f0-1763b872735d#pREXDkBmZSOnl29EzmoICcfx9S19ix6u","participant":{"id":"0195c6eb-99ae-73c1-94f0-1763b872735d","display_name":null,"external_id":null,"email":null}}},"id":"paths/~1api~1builder~1sessions~1{session_id}~1participants~1{participant_id}~1authenticate/post/responses/201/content/application~1json/example"},"paths/~1api~1builder~1sessions~1import/post/requestBody/content/multipart~1form-data/example":{"value":{"session_file":"<binary zip file>","handlers":{"success_handler":{"url":"https://example.com","method":"GET"},"error_handler":{"url":"https://example.com","method":"GET"},"delete_handler":{"url":"https://example.com","method":"GET"},"cancel_handler":{"url":"https://example.com","method":"GET"}},"participant":{"email":"john.doe@example.org","display_name":"John Doe","external_id":"user-123"},"ui_language":"en-GB"},"id":"paths/~1api~1builder~1sessions~1import/post/requestBody/content/multipart~1form-data/example"},"paths/~1api~1builder~1sessions~1import/post/responses/201/content/application~1json/example":{"value":{"data":{"id":"0195c6eb-99ae-73c1-94f0-1763b872735d","url":"https://app.builder.docue.com/builder-session/0195c6eb-99ae-73c1-94f0-1763b872735d#pREXDkBmZSOnl29EzmoICcfx9S19ix6u","participant":{"id":"0195c6eb-99ae-73c1-94f0-1763b872735d","display_name":"John Doe","external_id":"user-123","email":"john.doe@example.org"}}},"id":"paths/~1api~1builder~1sessions~1import/post/responses/201/content/application~1json/example"},"paths/~1api~1builder~1sessions~1import/post/responses/400/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":400,"text":"Bad Request"},"error":{"text":"Session import failed"}}},"id":"paths/~1api~1builder~1sessions~1import/post/responses/400/content/application~1json/example"},"paths/~1sign~1sessions/post/requestBody/content/application~1json/example":{"value":{"document_name":"Employment Agreement","document_author":"HR Department","external_id":"deal-42","expires_at":"2026-03-31T10:30:00.000Z","start":true,"files":[{"name":"Employment Agreement.pdf","url":"https://example.com/files/employment-agreement.pdf"}],"signature_position":"inline","participants":[{"name":"John Doe","external_id":"user-123","ui_language":"en-GB","signing_order":0,"deliveries":[{"type":"email","target":"john.doe@example.org","message":"Please sign by Friday."},{"type":"sms","target":"+358401234567","message":"Please sign by Friday."}],"signing_methods":[{"type":"eid","target":"fi_nordea"},{"type":"otp_sms"}],"signature_location":{"file_index":0,"page":1,"x":0.15,"y":0.36,"width":0.31,"height":0.1}},{"name":"Jane Roe","ui_language":"sv","signing_order":1,"deliveries":[{"type":"email","target":"jane.roe@example.org"}],"signing_methods":[{"type":"otp_email"}]}],"webhooks":[{"url":"https://example.com/webhooks/signing","secret":"your-shared-secret"},{"url":"https://example.com/webhooks/signing-audit"}]},"id":"paths/~1sign~1sessions/post/requestBody/content/application~1json/example"},"paths/~1sign~1sessions/post/requestBody/content/multipart~1form-data/example":{"value":{"data":{"document_name":"Employment Agreement","document_author":"HR Department","external_id":"deal-42","expires_at":"2026-03-31T10:30:00.000Z","start":true,"signature_position":"inline","files":[{"name":"Employment Agreement.pdf"}],"participants":[{"name":"John Doe","external_id":"user-123","ui_language":"en-GB","signing_order":0,"deliveries":[{"type":"email","target":"john.doe@example.org"}],"signing_methods":[{"type":"eid","target":"fi_nordea"},{"type":"otp_sms"}],"signature_location":{"file_index":0,"page":1,"x":0.15,"y":0.36,"width":0.31,"height":0.1}}],"webhooks":[{"url":"https://example.com/webhooks/signing","secret":"your-shared-secret"}]},"files":["(binary content of Employment Agreement.pdf)"]},"id":"paths/~1sign~1sessions/post/requestBody/content/multipart~1form-data/example"},"paths/~1sign~1sessions/post/responses/201/content/application~1json/example":{"value":{"data":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","status":"started","document_name":"Employment Agreement","document_author":"HR Department","external_id":"deal-42","expires_at":"2026-03-31T10:30:00.000Z","ui_domain":null,"email_from":null,"signature_position":"inline","files":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88501","file_name":"Employment Agreement.pdf","file_size":48211,"index":0}],"participants":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","status":"pending","status_changed_at":"2026-02-12T10:30:00Z","name":"John Doe","external_id":"user-123","ui_language":"en-GB","signing_order":0,"invitations":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88311","delivery":{"type":"email","target":"john.doe@example.org","message":"Please sign by Friday."},"timeline":{"created_at":"2026-02-12T10:30:00Z","sent_at":null,"opened_at":null,"revoked_at":null}},{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88312","delivery":{"type":"sms","target":"+358401234567","message":"Please sign by Friday."},"timeline":{"created_at":"2026-02-12T10:30:00Z","sent_at":null,"opened_at":null,"revoked_at":null}}],"signing_methods":[{"type":"eid","target":"fi_nordea"},{"type":"otp_sms"}]},{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88212","status":"pending","status_changed_at":"2026-02-12T10:30:00Z","name":"Jane Roe","external_id":null,"ui_language":"sv","signing_order":1,"invitations":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88321","delivery":{"type":"email","target":"jane.roe@example.org"},"timeline":{"created_at":"2026-02-12T10:30:00Z","sent_at":null,"opened_at":null,"revoked_at":null}}],"signing_methods":[{"type":"otp_email"}]}],"webhooks":[{"url":"https://example.com/webhooks/signing","secret_configured":true},{"url":"https://example.com/webhooks/signing-audit","secret_configured":false}]},"meta":{"status":{"code":201,"text":"Created"}}},"id":"paths/~1sign~1sessions/post/responses/201/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}/get/responses/200/content/application~1json/example":{"value":{"data":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","status":"pending","document_name":"Employment Agreement","document_author":"HR Department","external_id":"deal-42","expires_at":"2026-03-31T10:30:00.000Z","ui_domain":null,"email_from":null,"signature_position":"inline","files":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88501","file_name":"Employment Agreement.pdf","file_size":48211,"index":0}],"participants":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","status":"pending","status_changed_at":"2026-02-12T10:30:00Z","name":"John Doe","external_id":"user-123","ui_language":"en-GB","signing_order":0,"invitations":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88311","delivery":{"type":"email","target":"john.doe@example.org","message":"Please sign by Friday."},"timeline":{"created_at":"2026-02-12T10:30:00Z","sent_at":null,"opened_at":null,"revoked_at":null}},{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88312","delivery":{"type":"sms","target":"+358401234567","message":"Please sign by Friday."},"timeline":{"created_at":"2026-02-12T10:30:00Z","sent_at":null,"opened_at":null,"revoked_at":null}}],"signing_methods":[{"type":"eid","target":"fi_nordea"},{"type":"otp_sms"}]},{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88212","status":"pending","status_changed_at":"2026-02-12T10:30:00Z","name":"Jane Roe","external_id":null,"ui_language":"sv","signing_order":1,"invitations":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88321","delivery":{"type":"email","target":"jane.roe@example.org"},"timeline":{"created_at":"2026-02-12T10:30:00Z","sent_at":null,"opened_at":null,"revoked_at":null}}],"signing_methods":[{"type":"otp_email"}]}],"webhooks":[{"url":"https://example.com/webhooks/signing","secret_configured":true},{"url":"https://example.com/webhooks/signing-audit","secret_configured":false}]},"meta":{"status":{"code":200,"text":"OK"}}},"id":"paths/~1sign~1sessions~1{session_id}/get/responses/200/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}/get/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}/get/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1start/post/responses/200/content/application~1json/example":{"value":{"data":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","status":"started","document_name":"Employment Agreement","document_author":"HR Department","external_id":"deal-42","expires_at":"2026-03-31T10:30:00.000Z","ui_domain":null,"email_from":null,"signature_position":"inline","files":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88501","file_name":"Employment Agreement.pdf","file_size":48211,"index":0}],"participants":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","status":"pending","status_changed_at":"2026-02-12T10:30:00Z","name":"John Doe","external_id":"user-123","ui_language":"en-GB","signing_order":0,"invitations":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88311","delivery":{"type":"email","target":"john.doe@example.org"},"timeline":{"created_at":"2026-02-12T10:30:00Z","sent_at":null,"opened_at":null,"revoked_at":null}}],"signing_methods":[{"type":"eid","target":"fi_nordea"}]}]},"meta":{"status":{"code":200,"text":"OK"}}},"id":"paths/~1sign~1sessions~1{session_id}~1start/post/responses/200/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1start/post/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1start/post/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1start/post/responses/409/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":409,"text":"Conflict"},"error":{"text":"Only a pending signing session can be started"}}},"id":"paths/~1sign~1sessions~1{session_id}~1start/post/responses/409/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1pdf/get/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1pdf/get/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/200/content/application~1json/example":{"value":{"data":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88401","url":"https://example.com/webhooks/signing","status":"delivered","event":{"payload":{"workspace":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88001"},"session":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","external_id":"deal-42","status":"started","status_changed_at":"2026-02-12T10:30:00Z"},"participant":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","external_id":"user-123","session_id":"0196ae5b-2e9d-729f-aba5-fa4db6f881fd","status":"signed","status_changed_at":"2026-02-12T10:31:00Z","decline_reason":null}},"meta":{"type":"com.docue.sign.v1.participant.signed","id":"0196ae5b-2e9d-729f-aba5-fa4db6f88411","timestamp":"2026-02-12T10:31:00Z"}},"attempt":1,"retry_after":null,"last_error":null}],"meta":{"status":{"code":200,"text":"OK"}}},"id":"paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/200/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1webhooks/get/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1audit/get/responses/200/content/application~1json/example":{"value":{"data":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88401","actor":"integrator","actor_id":"0196ae5b-2e9d-729f-aba5-fa4db6f88001","type":"session.created","timestamp":"2026-09-24T11:16:15.897Z","client":{"ip":"203.0.113.10","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36"}}],"meta":{"status":{"code":200,"text":"OK"},"pagination":{"items":1,"total":null,"last_page":null,"page_size":100,"has_pages":false,"is_first":true,"pointer":{"previous":null,"current":null,"next":null}}}},"id":"paths/~1sign~1sessions~1{session_id}~1audit/get/responses/200/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/application~1json/example":{"value":{"name":"Appendix A - Terms.pdf","url":"https://example.com/files/appendix-a-terms.pdf","index":1},"id":"paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/multipart~1form-data/example":{"value":{"data":{"name":"Appendix A - Terms.pdf","index":1},"file":"(binary content of Appendix A - Terms.pdf)"},"id":"paths/~1sign~1sessions~1{session_id}~1files/post/requestBody/content/multipart~1form-data/example"},"paths/~1sign~1sessions~1{session_id}~1files/post/responses/201/content/application~1json/example":{"value":{"data":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88501","file_name":"Employment Agreement.pdf","file_size":48211,"index":0},{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88502","file_name":"Appendix A - Terms.pdf","file_size":12044,"index":1}],"meta":{"status":{"code":201,"text":"Created"}}},"id":"paths/~1sign~1sessions~1{session_id}~1files/post/responses/201/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1files/post/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1files/post/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1files/post/responses/409/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":409,"text":"Conflict"},"error":{"text":"No new files can be added to a started signing session"}}},"id":"paths/~1sign~1sessions~1{session_id}~1files/post/responses/409/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example":{"value":{"name":"John Doe","external_id":"user-123","ui_language":"en-GB","signing_order":1,"deliveries":[{"type":"email","target":"john.doe@example.org","message":"Please sign by Friday."}],"signing_methods":[{"type":"eid","target":"fi_nordea"}]},"id":"paths/~1sign~1sessions~1{session_id}~1participants/post/requestBody/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example":{"value":{"data":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88211","status":"pending","status_changed_at":"2026-02-12T10:30:00Z","name":"John Doe","external_id":"user-123","ui_language":"en-GB","signing_order":1,"invitations":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88311","delivery":{"type":"email","target":"john.doe@example.org","message":"Please sign by Friday."},"timeline":{"created_at":"2026-02-12T10:30:00Z","sent_at":null,"opened_at":null,"revoked_at":null}}],"signing_methods":[{"type":"eid","target":"fi_nordea"}]},"meta":{"status":{"code":201,"text":"Created"}}},"id":"paths/~1sign~1sessions~1{session_id}~1participants/post/responses/201/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1participants/post/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}/delete/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/email":{"value":{"type":"email","target":"john.doe@example.org","message":"Please sign by Friday."},"key":"email","summary":"Email delivery","id":"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/email"},"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/manual":{"value":{"type":"manual"},"key":"manual","summary":"Manual delivery where the integrator shares the URL","id":"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/requestBody/content/application~1json/examples/manual"},"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/email":{"value":{"data":{"id":"019f1833-f214-745e-a87c-fdf627b8bc6c","delivery":{"type":"email","target":"john.doe@example.org","message":"Please sign by Friday."},"timeline":{"created_at":"2026-06-30T11:04:45.331Z","sent_at":null,"opened_at":null,"revoked_at":null}},"meta":{"status":{"code":201,"text":"Created"}}},"key":"email","summary":"Email delivery","id":"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/email"},"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/manual":{"value":{"data":{"id":"019f1833-f214-745e-a87c-fdf627b8bc6c","signing_url":"https://sign.docue.com/s/#access-code","delivery":{"type":"manual","target":null},"timeline":{"created_at":"2026-06-30T11:04:45.331Z","sent_at":null,"opened_at":null,"revoked_at":null}},"meta":{"status":{"code":201,"text":"Created"}}},"key":"manual","summary":"Manual delivery","id":"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/201/content/application~1json/examples/manual"},"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations/post/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/409/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":409,"text":"Conflict"},"error":{"text":"Cannot revoke an invitation that was already revoked"}}},"id":"paths/~1sign~1sessions~1{session_id}~1participants~1{participant_id}~1invitations~1{invitation_id}/delete/responses/409/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1sender-uis/post/requestBody/content/application~1json/example":{"value":{"ui_language":"en-GB","handlers":{"return_handler":{"url":"https://example.com/sender-ui/return","method":"GET"}},"configuration":{"editable_parts":["files","participants","invitations","reminders","start_session"],"allowed_signing_methods":[{"type":"eid","target":"fi_nordea"},{"type":"otp_sms"}],"allow_start":true}},"id":"paths/~1sign~1sessions~1{session_id}~1sender-uis/post/requestBody/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/201/content/application~1json/example":{"value":{"data":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88401","url":"https://sign.docue.com/sender-session/0196ae5b-2e9d-729f-aba5-fa4db6f88401#access-code","handlers":{"return_handler":{"url":"https://example.com/sender-ui/return","method":"GET"}},"configuration":{"editable_parts":["files","participants","invitations","reminders","start_session"],"allowed_signing_methods":[{"type":"eid","target":"fi_nordea"},{"type":"otp_sms"}],"allow_start":true},"created_at":"2026-02-12T10:30:00Z","updated_at":"2026-02-12T10:30:00Z","last_authenticated_at":"2026-02-12T10:30:00Z"},"meta":{"status":{"code":201,"text":"Created"}}},"id":"paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/201/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1sender-uis/post/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/200/content/application~1json/example":{"value":{"data":[{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88401","handlers":{"return_handler":{"url":"https://example.com/sender-ui/return","method":"GET"}},"configuration":{"editable_parts":["files","participants","invitations","reminders","start_session"],"allowed_signing_methods":[{"type":"eid","target":"fi_nordea"},{"type":"otp_sms"}],"allow_start":true},"created_at":"2026-02-12T10:30:00Z","updated_at":"2026-02-12T10:35:00Z","last_authenticated_at":"2026-02-12T10:35:00Z"}],"meta":{"status":{"code":200,"text":"OK"}}},"id":"paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/200/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1sender-uis/get/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/requestBody/content/application~1json/example":{"value":{"ui_language":"en-GB"},"id":"paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/requestBody/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/201/content/application~1json/example":{"value":{"data":{"id":"0196ae5b-2e9d-729f-aba5-fa4db6f88401","url":"https://sign.docue.com/sender-session/0196ae5b-2e9d-729f-aba5-fa4db6f88401#access-code","handlers":{"return_handler":{"url":"https://example.com/sender-ui/return","method":"GET"}},"configuration":{"editable_parts":["files","participants","invitations","reminders","start_session"],"allowed_signing_methods":[{"type":"eid","target":"fi_nordea"},{"type":"otp_sms"}],"allow_start":true},"created_at":"2026-02-12T10:30:00Z","updated_at":"2026-02-12T10:35:00Z","last_authenticated_at":"2026-02-12T10:35:00Z"},"meta":{"status":{"code":201,"text":"Created"}}},"id":"paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/201/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}~1authenticate/post/responses/404/content/application~1json/example"},"paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete/responses/404/content/application~1json/example":{"value":{"data":null,"meta":{"status":{"code":404,"text":"Not Found"},"error":{"text":"Resource not found"}}},"id":"paths/~1sign~1sessions~1{session_id}~1sender-uis~1{sender_ui_id}/delete/responses/404/content/application~1json/example"}},"securitySchemeStore":{"APIKey":{"id":"APIKey","type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API authentication using bearer token."}},"servers":[{"url":"https://api.embed.docue.com","description":"Production (Sign Engine)"}],"specType":"openapi"},"options":{"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/embed-api/openapi.json?download"},{"url":"/_bundle/embed-api/openapi.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Embed API","description":"#### Authentication\n\nAll endpoints in this API require Bearer authentication using an API key. Include the API key obtained from the customer portal in the Authorization header of each request, formatted as follows:\n\n```\nAuthorization: Bearer <api_key>\n```\n\n#### Base URLs\n\nLegal Engine endpoints (`/api/...`) are served from `https://api.builder.docue.com` and Sign Engine endpoints (`/sign/...`) from `https://api.embed.docue.com`. The same API key works for both.\n"}},"baseSlug":"/embed-api/openapi","routesMapping":{}}