Skip to main content
POST
Create upload target
This is step 1 of the upload and render workflow. The response provides an uploadUrl for the file bytes and a slug for job creation. Send the file to uploadUrl with PUT, wait for a 2xx response, then pass the slug to POST /jobs.
External API v1 accepts one source file smaller than 5 GiB per presigned PUT. It does not support multipart or resumable uploads. If the transfer fails, send the whole file again. If this limit blocks your workflow, email support@renderjuice.com with the file sizes you need to upload. Your message helps us measure demand and prioritize multipart upload support.

Authorizations

Authorization
string
header
required

API key authentication. Format: Bearer RJ-XXX.... Get your API key from the Renderjuice dashboard.

Body

application/json
fileName
string
required

Source asset file name.

Minimum string length: 1
fileType
enum<string>
required

Supported upload type. Must match the file extension.

Available options:
blend,
zip

Response

Success

uploadUrl
string
required

Opaque presigned upload URL for a single PUT upload.

Minimum string length: 1
slug
string
required

Stable handle to pass to job creation later.

Minimum string length: 1
expiresAt
string<date-time>
required

ISO 8601 timestamp when the upload URL expires.