Input id

This type of input allows you to use an input from a previous conversion again.

This is only possible if you are the creator of the job the input_id is taken from.

Advantages of using this input type:

• You can avoid uploading a file twice
• Our servers can avoid downloading a file a second time from the URL you supplied
  • This is especially useful for big files

Once you create a job and it is finished, you receive data similar to this:

{
    ... extra information ...
    "input": [
        {
            "id": "5e0aa023-2235-4e78-a0fc-3106b2689dd3",
            "type": "remote",
            "source": "https://example-files.online-convert.com/raster%20image/png/example_small.png",
            "filename": "example_small.png",
            "size": 333205,
            "hash": "144979874887251a2150c5485e294001",
            "checksum": "144979874887251a2150c5485e294001",
            "content_type": "image/png",
            "created_at": "2017-08-17T16:36:44",
            "modified_at": "2017-08-17T16:36:45",
            "parameters": []
        }
    ],
    ... extra information ...
}

POST /v2/jobs HTTP/1.1
Host: api.api2convert.com
x-oc-api-key: <your API key>
Content-Type: application/json
Cache-Control: no-cache

{
    "input": [{
        "type": "input_id",
        "source": "5e0aa023-2235-4e78-a0fc-3106b2689dd3"
    }],
    "conversion": [{
        "target": "png"
    }]
}

curl -X POST \
  https://api.api2convert.com/v2/jobs \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -H 'x-oc-api-key: <your API key>' \
  -d '{
    "input": [{
        "type": "input_id",
        "source": "5e0aa023-2235-4e78-a0fc-3106b2689dd3"
    }],
    "conversion": [{
        "target": "png"
    }]
}'

User suggested filenames

Filenames can be specified as described in the section for remote inputs