Create upload job

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

Start an upload job

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

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.imagerelay.com/api/v2/upload_jobs \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400