Skip to main content
POST
/
jobs
/
join
Create join/stitch job
curl --request POST \
  --url https://api.nexrender.com/api/v2/jobs/join \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assets": [
    {
      "type": "video",
      "src": "<string>"
    }
  ],
  "settings": {
    "preset": "mp4"
  },
  "upload": {
    "prefix": "<string>",
    "outputUrl": "<string>",
    "provider": "s3",
    "params": {
      "region": "<string>",
      "bucket": "<string>",
      "accessKeyId": "<string>",
      "accessKeySecret": "<string>",
      "endpoint": "<string>",
      "acl": "<string>"
    }
  },
  "webhook": {
    "url": "<string>",
    "method": "POST",
    "headers": {},
    "data": {},
    "custom": false
  }
}
'
{
  "id": "<string>",
  "status": "queued",
  "outputUrl": "<string>",
  "children": [
    {
      "id": "<string>",
      "outputUrl": "<string>",
      "status": "<string>",
      "missingFonts": [
        "<string>"
      ]
    }
  ],
  "missingFonts": [
    "<string>"
  ]
}

Authorizations

Authorization
string
header
required

Bearer token authentication using API tokens for team-based access control.

You can generate your own API token at: https://app.nexrender.com/team/settings

Body

application/json

Configuration for creating a join/stitch job that combines multiple videos into one

assets
object[]
required

Ordered list of video or job assets to stitch together

Minimum array length: 1

A static video asset for the join/stitch operation

settings
object

Settings for the stitch/join operation

upload
object

Custom upload configuration (same as regular job creation)

webhook
object

Webhook configuration for job status notifications and callbacks

Response

Join job successfully created

Response after creating a job, includes children info for parent jobs

id
string
required

Unique job identifier

status
enum<string>
required

'queued' for regular jobs, 'pending' for parent jobs waiting on children

Available options:
queued,
pending
outputUrl
string
required

URL where the rendered output will be available

children
object[]

Child job details (only present for parent jobs with nested job assets)

missingFonts
string[]

List of fonts referenced in template but not found in team's font library