Remote URL upload

Fetch a file from a remote URL and store it in your Autorender workspace.

POST /api/v1/uploads/remote

Remote URL upload

cURL

curl --request POST \
  --url https://app-api.autorender.io/api/v1/uploads/remote \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "remote_url": "<string>",
  "file_name": "<string>",
  "folder": "<string>",
  "tags": [
    "<string>"
  ],
  "random_prefix": "<string>",
  "custom_id": "<string>",
  "metadata": "<string>",
  "webhook_url": "<string>"
}
'

201

{
  "id": "<string>",
  "file_no": "<string>",
  "workspace_id": "<string>",
  "name": "<string>",
  "path": "<string>",
  "url": "<string>",
  "width": 0,
  "height": 0,
  "size": 0,
  "mime_type": "<string>",
  "tags": [
    "<string>"
  ],
  "metadata": {},
  "custom_id": "<string>",
  "folder_no": "<string>",
  "is_duplicate": true,
  "created_at": "2023-11-07T05:31:56Z",
  "upload_source": "<string>",
  "thumbnail": "<string>",
  "extension": "<string>",
  "format": "<string>",
  "hash": "<string>",
  "is_private": true
}

Key type: accepts your public key or a private key. Uploading is the one thing a public key may do, so this endpoint works from browser and mobile code — see key types and scope.

Overview

Fetches a file from a public HTTP or HTTPS URL on our servers and stores it in your workspace. Use this when the file already lives on another server and you don’t want to download it locally first.

Required request

Headers

Header	Value
Authorization	Bearer YOUR_API_KEY
Content-Type	application/json

Body fields

Field	Required	Description
remote_url	Yes	Public HTTP or HTTPS URL of the file to fetch
folder	No	Destination path for the file (e.g. products/shoes)
tags	No	Comma-separated labels you can filter by later (e.g. hero,banner)
transform	No	Transformation string applied as the file is stored (e.g. w_800,h_600,c_crop)
metadata	No	JSON string of custom fields (e.g. {"source":"shopify"})
custom_id	No	Your own reference ID for the file
random_prefix	No	Set to "true" to append a random suffix to the stored name so filenames don’t collide

Minimal example

curl -X POST \
  https://upload.autorender.io/api/v1/uploads/remote \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"remote_url": "https://example.com/product.jpg"}'

Example with options

curl -X POST \
  https://upload.autorender.io/api/v1/uploads/remote \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "remote_url": "https://example.com/product.jpg",
    "folder": "products/shoes",
    "tags": "imported,shopify",
    "transform": "w_1200,f_auto,q_auto"
  }'

Next steps

Direct upload

Upload a file’s bytes directly from your backend.

List files

Page through the files in your workspace.

Authorizations

x-api-key · string · header · required

API key for public endpoints. Can also be provided via Authorization: Bearer

Body

application/json

remote_url · string<uri> · required

HTTP/HTTPS URL to fetch

file_name · string

Override file name

folder · string

Destination folder path

tags · string[] string

Tags array or comma-separated string

random_prefix · string

true/false to append random suffix

custom_id · string

metadata · string

JSON string of metadata object

webhook_url · string<uri>

Response

201

application/json

Upload created

Upload created

id · string · required

file_no · string · required

workspace_id · string · required

name · string · required

path · string · required

url · string · required

width · integer | null · required

Required range: -9007199254740991 <= x <= 9007199254740991

height · integer | null · required

Required range: -9007199254740991 <= x <= 9007199254740991

size · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

mime_type · string · required

tags · string[] · required

metadata · object | null · required

Show child attributes

custom_id · string | null · required

folder_no · string | null · required

is_duplicate · boolean · required

created_at · string<date-time> · required

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

upload_source · string · required

thumbnail · string · required

extension · string · required

format · string

hash · string

is_private · boolean