destination: "convertly-storage". Convertly can store the result, return signed download URLs, preserve extracted ZIP paths as folders, and keep large imports away from your app server.
Single-file URL transfers into Convertly Storage are asynchronous by default. The request creates a transfer job and returns 202 Accepted with a jobId; poll GET /api/jobs/{jobId} or subscribe to job updates to read the stored file result when it completes.
Public URL transfer
GET /api/jobs/job_123 includes the stored file metadata and signed download URL in results.
destination: "download" returns the fetched file as the response body. destination: "convertly-storage" stores the file asynchronously by default. Set "async": false only for small request/response workflows where you explicitly want the API request to wait for storage.
ZIP transfer and extract
Setextract: true to download a ZIP archive, extract it, and save each entry into Convertly Storage.
Cloud folder import
UsecloudSource instead of sourceUrl to import files from a provider API.
Google Drive
Google Drive imports use the Google Drive account connected in the Convertly dashboard.fileId instead of folderId to import a single Google Drive file.
S3
S3 imports use request-scoped credentials. The credentials are used for the import request and are not stored.key instead of prefix to import one S3 object.
Dropbox
Dropbox imports use a request-scoped Dropbox access token.Request fields
Response
Queued storage transfers return a job envelope. Completed transfer jobs expose the stored file in the jobresults. Synchronous storage transfers, ZIP extraction, and cloud folder imports return stored file or folder metadata immediately.