Skip to main content
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

  1. Request Fresh URLs: Always request new download URLs immediately before use. URLs expire after 60 minutes.
  2. Check Partial Errors: Inspect the errors array in the response to detect any files that could not be resolved.
  3. Stay Within Limits: A maximum of 25 file IDs are permitted per request. Split larger batches into multiple requests.
  4. Mind the Rate Limit: This endpoint is rate-limited to 20 requests per minute. Pace your requests accordingly for bulk workflows.

Authorizations

x-api-key
string
header
required

Body

application/json
file_ids
string<uuid>[]
required
Required array length: 1 - 25 elements
Pattern: ^([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})$

Response

Download URLs generated successfully

files
object[]
required
errors
object[]