DEVELOPER DOCUMENTATION

Convert files with an API.

Upload a file, create a conversion job, monitor progress, and download the result from your own application.

Base URLhttps://convert.brianrianrehan.comAuthenticationNone required
ACCESS

Ready to use.

These endpoints are public and do not require an API key or Authorization header.

ONE-STEP CONVERSION

Upload and convert directly

Send the file and choose the output format in the same request. The conversion job starts automatically.

POST/api/upload
curl -X POST https://convert.brianrianrehan.com/api/upload -F "file=@./photo.heic" -F "outputFormat=jpg"

The response returns a job ID and status. Supported output formats depend on the uploaded file.

OPTIONAL TWO-STEP FLOW

Choose conversion later

To upload first and select an output format later, omit outputFormat, then use the existing job endpoint.

POST/api/v1/jobs
curl -X POST https://convert.brianrianrehan.com/api/v1/jobs -H "Content-Type: application/json" -d '{"jobId":"UPLOAD_JOB_ID","outputFormat":"jpg"}'
STEP 2

Check job status

Poll until the status is completed or failed.

GET/api/v1/jobs/:jobId
curl https://convert.brianrianrehan.com/api/v1/jobs/JOB_ID
queuedprocessingcompletedfailed
STEP 3

Download the result

When complete, download the converted file directly.

GET/api/v1/jobs/:jobId/download
curl -L https://convert.brianrianrehan.com/api/v1/jobs/JOB_ID/download -o converted-file.jpg
LARGE FILES

Resumable uploads

Use the resumable endpoint for large files. Send the same uploadId, a zero-based chunkIndex, totalChunks, and finalize=true on the last chunk.

POST/api/upload/resumable
curl -X POST https://convert.brianrianrehan.com/api/upload/resumable -F "uploadId=UUID" -F "filename=large-video.mp4" -F "chunkIndex=0" -F "totalChunks=10" -F "finalize=false" -F "chunk=@chunk-0000"
FORMAT DISCOVERY

Supported formats

The upload response includes an outputs array with exact compatible formats. HEIC and HEIF images can be converted to JPG or PNG.