Request a Collection Export

Initiates an asynchronous export of all participant responses and uploaded files for a collection as a ZIP archive.

The export is generated out-of-band to handle large collections without hitting API timeout limits. The endpoint returns immediately with one of two outcomes:

202 Accepted — a new export job has been enqueued. Use the returned export_id to poll GET /collections/{collection_id}/export/{export_id} for status.
200 OK — a recent export already exists and is ready to download immediately.

Subsequent POST requests for the same collection are idempotent while an export is generating or complete; they return the existing job ID or download URL rather than re-triggering generation.

Only researchers with workspace access to the collection can request an export.

Initiates an asynchronous export of all participant responses and uploaded files for a collection as a ZIP archive. The export is generated out-of-band to handle large collections without hitting API timeout limits. The endpoint returns immediately with one of two outcomes: - **202 Accepted** — a new export job has been enqueued. Use the returned `export_id` to poll `GET /collections/{collection_id}/export/{export_id}` for status. - **200 OK** — a recent export already exists and is ready to download immediately. Subsequent POST requests for the same collection are idempotent while an export is generating or complete; they return the existing job ID or download URL rather than re-triggering generation. Only researchers with workspace access to the collection can request an export.

Authentication

AuthorizationToken

Header authentication of the form Token <token>

Path parameters

collection_idstringRequired

Response

Export already complete

statusenum

Allowed values:

urlstringformat: "uri"

Presigned HTTPS URL for downloading the ZIP archive. Valid for 24 hours. Re-poll to get a refreshed URL if expired.

expires_atdatetime

ISO 8601 timestamp indicating when the presigned URL expires.

Errors

403

Forbidden Error

Initiates an asynchronous export of all participant responses and uploaded files for a collection as a ZIP archive.

The export is generated out-of-band to handle large collections without hitting API timeout limits. The endpoint returns immediately with one of two outcomes:

202 Accepted — a new export job has been enqueued. Use the returned export_id to poll GET /collections/{collection_id}/export/{export_id} for status.
200 OK — a recent export already exists and is ready to download immediately.

Subsequent POST requests for the same collection are idempotent while an export is generating or complete; they return the existing job ID or download URL rather than re-triggering generation.

Only researchers with workspace access to the collection can request an export.