Download Data Export

GET /api/organization/data-export/{exportId}/download

Returns a presigned URL for the export ZIP. The URL is valid for 5 minutes; the object key itself is never exposed and the storage bucket is not browsable, so knowing an export id is not access, an authenticated administrator of the owning organization is.

Query parameters

Example (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
EXPORT_ID="0f0f2f6a-2b3b-4a2f-9a7c-3e5f8c1d2b44"

# Straight to the file
curl -L -o export.zip \
  "$BASE_URL/api/organization/data-export/$EXPORT_ID/download?redirect=1" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "url": "https://<bucket>.<region>.your-objectstorage.com/data-exports/org-12/0f0f2f6a-...zip?X-Amz-Signature=...",
  "expiresInSeconds": 300,
  "sizeBytes": 18446721,
  "filename": "uptimeify-export-0f0f2f6a-2b3b-4a2f-9a7c-3e5f8c1d2b44.zip"
}

Each call increments downloadCount and updates lastDownloadedAt on the export record.

Common errors

• 400 User must belong to an organization when no organization can be derived from the session or token
• 401 Unauthorized when you are not authenticated
• 403 Forbidden when your role cannot administer the organization
• 404 Export not found when the id does not belong to your organization
• 409 Export is not downloadable (data.code: exportNotReady) while the export is queued, generating or failed
• 410 Export download window has expired (data.code: exportExpired) after the 7-day window