Docmost Octri Preview
POST/pages/import-zip

Import a zip archive (Notion, Confluence, or generic)

Imports are processed asynchronously. Returns a file task that can be polled for progress.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

4 body fields
filestringrequired
ZIP archive containing pages to import.
parentPageIdstringoptional
ID of the parent page. Imported pages are created as children of this page. If omitted, imported at root level.
sourcestringrequired
Source format of the zip contents. `notion`: Notion export (HTML or Markdown). `confluence`: Confluence space export (HTML format). `generic`: generic zip of Markdown or HTML files.
Allowed:notionconfluencegeneric
spaceIdstringrequired
ID of the space to import pages into.

3 status codes
200Async file task created
dataobjectoptional
statusintegeroptional
successbooleanoptional
400Validation error
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
403Forbidden
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

A 400 is returned: Validation error. A 403 is returned: Forbidden.