v1

latestOpenAPI 3.1.02026-07-2664485505.4 KB
Admin API

Get workspace export status

get/v1/spaces/{space_id}/exports/{export_job_id}

Path parameters

export_job_idstring required

Identifier of the export job, as returned by the enqueue endpoint.

space_idstring required

UUID of the workspace (space) the export belongs to.

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Response

created_timenumber required
export_format'html' | 'markdown' | 'pdf' required
export_job_idstring required

Identifier of the export job, as returned by the enqueue endpoint.

export_type'page' | 'space' | 'teamspace' required

Whether an entire workspace ('space'), a teamspace, or a single 'page' was exported.

last_edited_timenumber required
pages_exportednumber required
status'completed' | 'failed' | 'in_progress' | 'url_generation_failed' required

Current state of the export: - 'in_progress': the export has not finished yet. - 'completed': the export finished and 'download_urls' is available. - 'url_generation_failed': the export finished, but a download URL could not be generated. - 'failed': the export itself did not finish; see 'error_type' and 'error_message'.

download_urlsstring[]

Short-lived, bot-scoped download URLs for the completed export. Always present when 'status' is 'completed', and absent for every other status.

error_messagestring
error_typestring
url_expires_timenumber