Generate bulk file download URLs
Files
Generate Bulk File Download URLs
Generate signed download URLs for multiple files in a single request.
POST
Generate bulk file download URLs
Generate signed download URLs for multiple files in a single request. Returns partial success — URLs for accessible files plus errors for any failures. Files must be owned by the authenticated user.
Key Features
- Partial Success: If some file IDs are inaccessible or invalid, the response still returns URLs for the files that succeeded, alongside per-file errors for those that failed.
- Batch Efficiency: Download URLs for up to 25 files in a single call instead of making individual requests.
- Short-lived URLs: Signed URLs expire after 60 minutes. Do not store them — request fresh URLs when needed.
Best Practices
- Request Fresh URLs: Always request new download URLs immediately before use. URLs expire after 60 minutes.
- Check Partial Errors: Inspect the errors array in the response to detect any files that could not be resolved.
- Stay Within Limits: A maximum of 25 file IDs are permitted per request. Split larger batches into multiple requests.
- Mind the Rate Limit: This endpoint is rate-limited to 20 requests per minute. Pace your requests accordingly for bulk workflows.
Authorizations
Body
application/json
Required array length:
1 - 25 elementsPattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$