Skip to main content
POST
Create job
This is step 3 of the upload and render workflow. Call this endpoint after the presigned PUT from POST /uploads returns a 2xx response. Send the upload slug in this request, then use the returned job id for validation, rendering, status, and downloads.

Authorizations

Authorization
string
header
required

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

Body

application/json
slug
string
required

Upload slug returned by the external upload endpoint. Use this to create the job after the file upload completes.

Minimum string length: 1

Response

Success

id
string<uuid>
required

Unique identifier of the job

Example:

"123e4567-e89b-12d3-a456-426614174000"

status
enum<string>
required

Current status of the job

Available options:
created,
validating,
validated,
debugging,
rendering,
finalizing,
completed,
failed,
canceled,
booting,
suspended
Example:

"completed"

userId
string<uuid>
required

Identifier of the user who created the job.

workspaceId
string<uuid>
required

Identifier of the workspace that owns the job.

createdAt
string<date-time>
required

ISO 8601 timestamp when the job was created

updatedAt
string<date-time>
required

ISO 8601 timestamp when the job was last updated

analysisId
string<uuid> | null

Opaque identifier of the associated analysis.

rootFolderId
string<uuid> | null

Identifier of the job input root folder.

normalizedSeconds
number

Normalized rendering time in seconds (adjusted for GPU performance)

previewUrl
string<uri> | null

URL to a preview image of the rendered output, if available

failedReason
object | null

Failure information intended for the client.

requestedConfig

Override configuration that was requested for this job

finalConfig
object | null

Final configuration that was used for rendering (may differ from requested)

output
object

Information about the job output files

isAnalysisSkipped
boolean

Whether scene file analysis was skipped for this job

projectId
string<uuid> | null

Project containing the job, when assigned.

uploadPreflight
object | null

Client-side ZIP inspection data captured before upload.

analysis
object | null

Client-visible validation state and scene metadata.

sceneFile
object

Client-visible scene file metadata.

{key}
unknown