- Start the export and receive an
exportId. - Poll until
stateiscompleted. - Download the PDF from
exportUrl.
Endpoints
Request body
All fields are optional. WithoutsheetIds, every sheet in the project is exported.
Selecting sheets
Every ID insheetIds must belong to the project. If any well-formed ID does not, the request is rejected with 422 Unprocessable Entity, each offending ID is named, and no export starts:
sheetIds, a non-UUID, or an invalid printMode or paperSize) returns 400 Bad Request with the same envelope.
Response
Both endpoints return the same shape.exportUrl is null until state is completed:
state is processing, completed, or failed. exportUrl is null while processing or failed. Once completed, it is a presigned URL that expires 10 minutes after each poll. Every poll returns a fresh one.
Polling
PollGET /v1/exports/{exportId} until state is completed or failed, with backoff rather than a tight loop. Small projects usually finish in a few seconds; large ones can take 30 seconds or more.
Notes
- Formatting matches Print in the app, including project-level print preferences such as member schedules.
- The export carries the organisation’s watermark, if it has one.
- If
statebecomesfailed, the export will not complete; start a new one. Common causes are an unsolved sheet or a temporary rendering failure. - Use the
exportUrlfrom the latest poll; there is no need to cache it.