Bulk conversions

Bulk uploads let Forge Pro users submit up to 20 files in a single request, each with its own target format and preset. Free users see an upgrade prompt instead.

Pro only

Bulk is a Forge Pro feature. Free accounts can only convert one file at a time. Upgrade to unlock bulk.

How it works

1. Add files — drop up to 20 files into the bulk dropzone on the Bulk page.
2. Choose targets — for each file, pick a target format and (optionally) a preset.
3. Submit — the web app uploads all files in parallel, then sends a single POST /conversions/bulk request.
4. Track progress — the status grid shows per-file progress with an overall progress bar.
5. Download — download individual files as they complete, or wait for the full batch.

Every file counts

Each file in a bulk submission counts toward your daily conversion limit. If you're on the Free plan (5/day), you can't sneak 20 conversions through a single bulk request.

Aggregate status

A bulk submission has an overall status that rolls up from its children:

Status	Meaning
queued	All files are waiting in the queue
processing	At least one file is being converted
completed	Every file converted successfully
partial	Some files succeeded, some failed
failed	Every file failed

Partial results are normal — you can still download the files that succeeded and retry the ones that failed individually.

Via the API

# Create a bulk submission
curl -X POST https://fileforge-api.aldrickb.app/v1/conversions/bulk \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "input_file_id": "...", "target_format": "jpg", "preset": { "id": "web" } },
      { "input_file_id": "...", "target_format": "mp3", "preset": { "id": "standard" } }
    ]
  }'

# Response
{
  "bulk_id": "9b1deb4d-3b7d-...",
  "items": [
    { "conversion_id": "...", "status": "queued" },
    { "conversion_id": "...", "status": "queued" }
  ]
}

# Poll aggregate status
curl https://fileforge-api.aldrickb.app/v1/conversions/bulk/{bulk_id} \
  -H "Authorization: Bearer $KEY"

See API → Conversions for the full endpoint reference.

Limits

• Max files per bulk: tier.bulk_max (20 for Pro, 1 for Free).
• Each file still subject to normal size limits: 10 MB (Free) or 500 MB (Pro).
• Each file counts toward the daily conversion limit — there is no "bulk discount" on the counter.