Overview

This page describes how to export content using the REST API. To export content you have to:

  1. Create an access token for authentication (once).
  2. Start the export job (the server will return the ID of the job).
  3. Fetch the status of the export job repeatedly until it finished.
  4. Download the exported file when the export job has finished.

For more details, read on or take a look at the example script (tested with Python 3.9).

Personal Access Token(s) can be created in your user profile. Simply navigate to: User Profile Icon (top right) > Settings > Scroll HTML Exporter API Tokens

This token can be used for as many exports as you want, as long as it exists.

Once created, the token is must be added via the Authorization header to all HTTP requests:

Authorization: Bearer <my-token>
CODE


IDs used in Export Parameters

When starting an export, you may need to provide several IDs to the API. Here's how to locate them:

Page / Blog Post ID

Can be found by opening the Page Information screen via ... → Advanced details → Page Information

The ID is contained in the URL of this screen, for example: .../wiki/pages/viewinfo.action?pageId=2053799937 

Template IDCan be retrieved by inspecting the template information in the space / global template list's Action menu.