Guide
Output & cloud storage
Download URLs and S3/GCS/Azure/SFTP/Drive/YouTube export.
By default, converted files are made available as download URLs. You can also push outputs straight to your own cloud storage.
Download URLs
When a job completes, each entry in output[] has a uri, a name, a size and a content_type.
"output": [{ "uri": "https://.../result.pdf", "name": "result.pdf", "content_type": "application/pdf" }]
Retention and where the bytes live
An output file is removed when its retention window expires. The window that applies to your account is published once, in the x-sat-published-limits extension at the root of the generated OpenAPI document, and is deliberately not restated here so the two can never disagree.
We make no backups of the files you transmit for conversion. Encrypted backups of our databases do exist and are kept for the limited period stated in the privacy policy.
Data is stored in Europe; delivered through a global content delivery network. Our object-storage processor is Cloudflare R2 (EU), whose buckets are created in the EU jurisdiction on its European endpoint.
output_target below leaves that arrangement at the moment we hand it over. From then on its location, its retention and its backups are yours, not ours.Cloud export targets
Attach an output_target to a conversion to deliver results elsewhere. Supported providers:
| type | Destination |
|---|---|
amazons3 | Amazon S3 |
googlecloud | Google Cloud Storage |
azure | Azure Blob Storage |
sftp | SFTP server (password authentication) |
gdrive | Google Drive |
youtube | YouTube (video upload) |
Example: export to S3
"conversion": [{
"category": "image",
"target": "png",
"output_target": [{
"type": "amazons3",
"parameters": { "bucket": "my-bucket", "file": "out/result.png" },
"credentials": { "accesskeyid": "<your-access-key-id>", "secretaccesskey": "<your-secret-access-key>" }
}]
}]
parameters differ per provider (e.g. S3 needs bucket + file, Azure needs a container + file).Build an output target
Pick a destination to see its parameters and credentials, with a copy-pasteable request preview. Required fields are pre-filled with example values — replace the credentials with your own.
Loading options…