Run a media tool against a stored file
Apply any Media Tools API operation (remove-background, transform, adjust, trim, convert, watermark, etc.) to a file that already lives in Convertly Storage, without re-uploading the source bytes. The output is saved as a new stored file in the same folder as the source unless overage limits force a 403. Set preview: true to receive a data-URL preview without writing to storage.
Authorizations
Dashboard-generated Convertly API key. Keys currently begin with cvly_.
Path Parameters
Body
Which Media Tools operation to run against the stored file.
remove-background, transform, vectorize, watermark, adjust, trim, convert, extract-audio, gif, poster-frame, storyboard Tool-specific parameters. Send the same fields you would send as form data to the equivalent /api/media/* route, as a JSON object of string values.
When true, returns a base64 data URL in the response without writing a new stored file. Useful for in-app previews.
Watermark only. A data: URL containing the logo image. Required for tool=watermark with a logo input.
Response
New stored file (or preview when preview=true)
- Option 1
- Option 2