The /upload/handle Robot

Transloadit can handle uploads of your users directly.

The /upload/handle Robot receives uploads that your users throw at you from browser or apps, or that you throw at us programatically.

Parameters

Name Type Default Description
output_meta Object '{}' Allows you to specify a set of meta data that is more expensive on cpu power to calculate, and thus is disabled by default to keep your Assemblies processing fast. You can add "has_transparency": true in this object to extract if uploaded images contain transparent parts.

Live demos

Our /upload/handle Robot can be used in combination with other Robots, to create powerful workflows unique to your use case.
Here are a few example scenarios, and the required the Assembly Instructions to implement them.
You can also try demos of these examples right here, live on our website.

Specify multiple encoding Steps for a single file

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "ipad_encoded": {
      "use": [":original"],
      "robot": "/video/encode",
      "result": true,
      "ffmpeg_stack": "v2.2.3",
      "preset": "ipad-high"
    },
    "iphone_encoded": {
      "use": [":original"],
      "robot": "/video/encode",
      "result": true,
      "ffmpeg_stack": "v2.2.3",
      "preset": "iphone"
    },
    "thumbnailed": {
      "use": [":original"],
      "robot": "/video/thumbs",
      "result": true,
      "ffmpeg_stack": "v2.2.3"
    },
    "thumbs_resized": {
      "use": ["thumbnailed"],
      "robot": "/image/resize",
      "result": true,
      "height": 130,
      "imagemagick_stack": "v1.0.0",
      "width": 130
    },
    "exported": {
      "use": [":original", "ipad_encoded", "iphone_encoded", "thumbs_resized"],
      "robot": "/s3/store",
      "credentials": "demo_s3_credentials"
    }
  }
}

Automatically process multiple file types

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "image_thumbed": {
      "use": [":original"],
      "robot": "/image/resize",
      "result": true,
      "format": "png",
      "height": 240,
      "imagemagick_stack": "v1.0.0",
      "width": 320
    },
    "video_thumbed": {
      "use": [":original"],
      "robot": "/video/thumbs",
      "result": true,
      "background": "#000000",
      "count": 4,
      "ffmpeg_stack": "v2.2.3",
      "height": 240,
      "resize_strategy": "pad",
      "width": 320
    },
    "ipad_encoded": {
      "use": [":original"],
      "robot": "/video/encode",
      "result": true,
      "ffmpeg_stack": "v2.2.3",
      "preset": "ipad-high"
    },
    "exported": {
      "use": ["image_thumbed", "video_thumbed", "ipad_encoded", ":original"],
      "robot": "/s3/store",
      "credentials": "demo_s3_credentials"
    }
  }
}

Did you know?

You can easily combine Robots to create powerful workflows, unique to your business.
This is the power of Transloadit.