Skip to main content
A join job stitches an ordered list of video clips into a single output file. Each clip can be a static video URL or a nested job definition that renders first. The whole pipeline - render child jobs, wait for them, stitch - is handled in one API call.

​
How It Works

Submit a POST /jobs/join request with an ordered assets array. Each asset is either:
  • type: "video" - a direct URL to an existing video file
  • type: "job" - a job definition that Nexrender renders first, then uses the output
When job assets are present, Nexrender renders all child jobs in parallel, waits for them to complete, then stitches the outputs in the order you specified.

​
Basic Example - Static Videos

The simplest case: stitch two existing video files together.

​
Mixed Example - Render and Stitch

Render a personalized middle segment from a template and stitch it between a static intro and outro.
The parent enters pending while the child job renders. Once the child finishes, the stitch runs automatically and the parent transitions to finished.

​
Request Fields

​
Top-level

​
Video Asset (type: "video")

​
Job Asset (type: "job")

​
Tracking a Join Job

Track the join job with GET /jobs/:id as you would any other job. When all child jobs are rendering, the parent is pending. Once children complete and the stitch begins, the parent moves to render:dorender, then finished. The outputUrl in the creation response is populated immediately and points to where the final stitched file will be available once the job is finished.

​
When to Use Join Jobs

Join jobs are the right choice when you want to concatenate clips end-to-end:
  • Intro + personalized body + outro for marketing emails or event invites
  • Chapter-by-chapter assembly of a long-form video from separate renders
  • Combining a rendered animation with pre-recorded footage clips
If you need to composite one render as a layer inside another composition (rather than appending clips), use a Nested Job instead.

Nested Jobs

Composite child renders as layers inside a parent composition

Batch Jobs

Submit up to 1,000 jobs in a single request