The /upload/handle Robot

We 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 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.