Create upload job

post

https://api.imagerelay.com/api/v2/upload_jobs

Start an upload job

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Each upload job will create a single asset. You'll need the id and files.id values from a 200 success response to upload your file to the Upload File Chunks endpoint.

Body Params

folder_id

int32

required

ID of the folder to which the uploaded asset will be added.

file_type_id

int32

required

ID of the file type/metadata template to which the asset will be associated.

files

array of objects

required

Array of file objects, but should only contain a singlular file

files*

prefix

string

Optional subfolder path where the file will be stored

terms

array of objects

Optional metadata term values to be applied to the file being uploaded. These term IDs must belong to the provided file_type_id parent

terms

expires_on

date

Optional date to assign as the expiration date for the file being uploaded. See documentation for details on file expiration dates

keyword_ids

array of int32s

Optional array of keyword (tag) IDs to be applied to the file being uploaded

keyword_ids

Responses

200200

400400