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.

An output delivered to an 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:

typeDestination
amazons3Amazon S3
googlecloudGoogle Cloud Storage
azureAzure Blob Storage
sftpSFTP server (password authentication)
gdriveGoogle Drive
youtubeYouTube (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>" }
  }]
}]
Treat storage credentials as secrets. Required 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…