Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.
Configuration for creating a batch of render jobs in a single request (1 to 1000 jobs)
jobs
object[]
required
Array of job configurations to create as a batch. Each item follows the same schema as a single job creation request, plus an optional batchItemId string (at most 255 characters) that identifies the job within the batch when it is retried. Items without one are matched by their position.
Required array length: 1 - 1000 elements
Show child attributes
batchId
string
Optional client-chosen ULID that makes the request safe to retry. Sending a batch again with the same batchId creates only the jobs that are not in it yet: the response is 200 with status 'replayed' when nothing was missing, or 'partial' when the missing jobs were created. Retries are recognised for 30 days, while the batch's jobs are kept. Requests with the same batchId must not run at the same time: two that overlap on the server can both create jobs. A timeout on your side does not mean the server stopped processing, so after a timeout wait until GET /batches/{id} stops changing before retrying. Without it the API generates one, and a retry creates a new batch.
Pattern: ^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$
Response
A retry with an existing batchId. Status 'replayed' when every job already existed, 'partial' when the missing jobs were created now.
Response after creating a batch of jobs, including per-job results and any errors
batchId
string
required
Unique batch identifier in ULID format for tracking the entire batch
status
enum<string>
required
'created' if all jobs succeeded, 'partial' if some failed or a retry created only the missing jobs, 'error' if all failed, 'replayed' if a retry with the same batchId found every job already created
Available options:
created,
partial,
error,
replayed
totalJobs
integer
required
Total number of jobs in the batch request
successCount
integer
required
Number of successfully created jobs
jobs
object[]
required
Array of successfully created job details
Show child attributes
error
string
Present on 409 and 503 responses: why the batch could not be completed
errorCode
string
Present on 409 and 503 responses, for example BATCH_ALREADY_PARTIAL or BATCH_RETRYABLE
errors
object[]
Array of errors for failed jobs (only present when status is 'partial' or 'error')
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Nexrender Cloud Documentation","colors":{"primary":"#A06BC6","light":"#A06BC6","dark":"#A06BC6"},"logo":{"light":"https://mintcdn.com/nexrender/hhU8sut1bRm3T6o4/logo/nx-text-logo-dark.png?fit=max\u0026auto=format\u0026n=hhU8sut1bRm3T6o4\u0026q=85\u0026s=dfd4191163c2c6667fef64145f151792","dark":"https://mintcdn.com/nexrender/hhU8sut1bRm3T6o4/logo/nx-text-logo-light.png?fit=max\u0026auto=format\u0026n=hhU8sut1bRm3T6o4\u0026q=85\u0026s=1c2c9518add002354ffa95e3e3c7a7d9"},"favicon":"https://mintcdn.com/nexrender/EcfHHWVlIZh_8xU2/favicon.svg?fit=max\u0026auto=format\u0026n=EcfHHWVlIZh_8xU2\u0026q=85\u0026s=1924353b78c21a7935bd1746cd89f54f","navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.nexrender.com"}},"footer":{"socials":{"github":"https://github.com/inlife/nexrender","linkedin":"https://www.linkedin.com/company/nexrender"}},"icons":{"library":"lucide"},"integrations":{"ga4":{"measurementId":"G-WR9FJ0LMZF"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nexrender","hasAudioNarration":false,"actualSubdomain":"nexrender","customDomains":["www.nexrender.com"],"gitSource":{"type":"github","owner":"nexrender","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af36c1b1f38dc5cafeb218d","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":42},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Rendering Jobs","count":28},{"language":"default","tag":"Templates Management","count":11},{"language":"default","tag":"Functions","count":9},{"language":"default","tag":"Fonts Management","count":8},{"language":"default","tag":"Essentials","count":7},{"language":"default","tag":"Scripting","count":5},{"language":"default","tag":"Managing Templates","count":5},{"language":"default","tag":"Batch Jobs","count":3}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/batch-management/create-batch-of-jobs","slug":"/api-reference/batch-management/create-batch-of-jobs","pageMetadata":{"title":"Create batch of jobs","description":"Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.","deprecated":null,"version":null,"openapi":"/openapi.json post /batches","href":"/api-reference/batch-management/create-batch-of-jobs","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create batch of jobs","description":"Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.","deprecated":null,"version":null,"openapi":"/openapi.json post /batches","href":"/api-reference/batch-management/create-batch-of-jobs","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create batch of jobs","description":"Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.","x-mint":{"mcp":{"enabled":true,"name":"create-batch","description":"Submit up to 1000 render jobs in a single batch request. Returns per-job results with a shared batch ID for tracking."}},"requestBody":"eec57547-9144-40a5-81c1-3d2b8d2ff6f2","responses":{"200":"1e231449-4510-4b6c-a478-b95d3ed8c8af","201":"b9dd2d62-4197-46e4-9cd6-3b46b32cc329","400":"ccdcf50b-0baf-4267-a3a9-3db537ef506c","401":"78015434-1207-471b-bac2-c8303171f754","403":"31ca256c-840d-408f-b6fb-ba488ca106a8","409":"e2f8959d-4040-40d4-9be8-0174f967007a","503":"59403a01-4f97-4c50-9096-b54ee3140161"},"tags":["Batch Management"],"operationId":"createBatch","method":"post","type":"path","servers":["4133949a-4c35-4adc-be73-807c1d304960"],"security":["9409df23-e540-4851-a6b9-305f5ba80c53"],"path":"/batches","baseUrlOptions":["https://api.nexrender.com/api/v2"],"title":"Create batch of jobs","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Configuration for creating a batch of render jobs in a single request (1 to 1000 jobs)","properties":{"jobs":{"type":"array","description":"Array of job configurations to create as a batch. Each item follows the same schema as a single job creation request, plus an optional `batchItemId` string (at most 255 characters) that identifies the job within the batch when it is retried. Items without one are matched by their position.","items":{"type":"object","description":"Configuration object for creating a new render job with template, assets, and options","properties":{"template":{"type":"object","description":"Template configuration defining the After Effects project and composition to render. Provide exactly one of `id` (an uploaded template) or `src` (a template URL); sending both, or neither, is rejected.","properties":{"id":{"type":"string","pattern":"^[A-Z0-9]{26}$","description":"Unique template identifier in ULID format (26 characters, uppercase alphanumeric). Use instead of `src`.","uniqueKey":"jobs.items.[INDEX].template.id","typeLabel":"string"},"src":{"type":"string","description":"Use instead of `id`. Public HTTP(S), native s3:/gs:, inline data:, or a file: URL inside the current job work directory for an After Effects template (.aep, .mogrt, or .zip file). The worker rejects paths and symlinks escaping that directory and non-public network destinations. Requires `name`.","uniqueKey":"jobs.items.[INDEX].template.src","typeLabel":"string"},"name":{"type":"string","description":"Project file name. Required with `src`: for a .zip, the path of the .aep inside the archive (for example `project/main.aep`); otherwise the file name of the .aep or .mogrt. With `id`, it defaults to the name detected when the template was uploaded.","uniqueKey":"jobs.items.[INDEX].template.name","typeLabel":"string"},"composition":{"oneOf":[{"type":"string","description":"Name of the specific composition within the template to render (optional for .mogrt)","uniqueKey":"jobs.items.[INDEX].template.composition.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the specific composition within the template to render (optional for .mogrt)","uniqueKey":"jobs.items.[INDEX].template.composition.oneOf.1","typeLabel":"null"}],"uniqueKey":"jobs.items.[INDEX].template.composition","typeLabel":"string | null"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"jobs.items.[INDEX].template","typeLabel":"object"},"preview":{"type":"boolean","default":false,"description":"Generate a low-quality preview render instead of full quality output","uniqueKey":"jobs.items.[INDEX].preview","typeLabel":"boolean"},"fonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].fonts.items.[INDEX]","typeLabel":"string"},"default":[],"description":"List of font file names to include in the render environment","uniqueKey":"jobs.items.[INDEX].fonts","typeLabel":"string[]"},"assets":{"type":"array","items":{"oneOf":[{"type":"object","description":"Asset to be used in job rendering, containing source information and target layer details. For function assets, provide the function identifier in `name` and arguments in `params`.","required":["type"],"properties":{"type":{"type":"string","description":"Asset type (e.g., image, video, audio, text, data, script, job)","isRequired":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.type","typeLabel":"string"},"src":{"type":"string","description":"Public HTTP(S), native s3:/gs:, inline data:, or a file: URL inside the current job work directory. The worker rejects local paths and symlinks escaping that directory. Other schemes and non-public network destinations are rejected.","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.src","typeLabel":"string"},"layerName":{"type":"string","description":"Target layer name in the After Effects composition where this asset will be applied","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.layerName","typeLabel":"string"},"name":{"type":"string","description":"Human-readable name for the asset. For function assets (`type: function`), this should be the NX function name (for example, `nx:layer-autoscale`).","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.name","typeLabel":"string"},"conform":{"type":"boolean","description":"When true for video, image, or audio assets, the worker normalizes the downloaded media to a render-engine-safe target format before assembly. If omitted, the API auto-enables conform for known risky inputs such as WebM, WebP, GIF, and OGG/OGA sources. GIF inputs are converted to a ProRes 4444 MOV file and treated as video.","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.conform","typeLabel":"boolean"},"params":{"type":"object","description":"Optional parameters for function assets. For supported NX layer functions (`nx:layer-autoscale`, `nx:layer-duration-set`, `nx:layer-start-set`, `nx:layer-state-set`, `nx:solid-color-set`, `nx:text-params-set`), `params.layerName` accepts a single string or an array of strings. When an array is provided, the API expands the function asset into multiple per-layer assets while preserving the original `assets` order.","properties":{"layerName":{"oneOf":[{"type":"string","description":"Target layer name(s) for function assets","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.params.layerName.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.params.layerName.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Target layer name(s) for function assets","minItems":1,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.params.layerName.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.params.layerName","typeLabel":"string | string[]"}},"additionalProperties":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0.params","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"A nested job asset that renders a child job first, then uses its output as a video/image asset in the parent composition. The child job's output URL is automatically injected into the parent's assets. A child can have nested job assets of its own, up to 4 levels of child jobs below the submitted job (NESTED_JOB_ASSETS otherwise). A job tree has at most 50 jobs, counting the submitted job and every nx:genai function (JOB_TREE_TOO_LARGE otherwise).","required":["type","layerName","template"],"properties":{"type":{"type":"string","enum":["job"],"description":"Must be 'job' to indicate this is a nested job asset","isRequired":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"layerName":{"type":"string","description":"Target layer name in the parent composition where the child job's output will be placed (required)","isRequired":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.layerName","typeLabel":"string"},"template":{"type":"object","description":"Template configuration for the child job","properties":{"id":{"type":"string","pattern":"^[A-Z0-9]{26}$","description":"Template ID for the child job (required)","isRequired":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.template.id","typeLabel":"string"},"composition":{"type":"string","description":"Composition name to render in the child job (required)","isRequired":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.template.composition","typeLabel":"string"},"name":{"type":"string","description":"Template name (optional)","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.template.name","typeLabel":"string"}},"required":["id","composition"],"isRequired":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.template","typeLabel":"object"},"assets":{"type":"array","items":{"oneOf":[{"type":"object","description":"Asset to be used in job rendering, containing source information and target layer details. For function assets, provide the function identifier in `name` and arguments in `params`.","required":["type"],"properties":{"type":{"type":"string","description":"Asset type (e.g., image, video, audio, text, data, script, job)","isRequired":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.type","typeLabel":"string"},"src":{"type":"string","description":"Public HTTP(S), native s3:/gs:, inline data:, or a file: URL inside the current job work directory. The worker rejects local paths and symlinks escaping that directory. Other schemes and non-public network destinations are rejected.","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.src","typeLabel":"string"},"layerName":{"type":"string","description":"Target layer name in the After Effects composition where this asset will be applied","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.layerName","typeLabel":"string"},"name":{"type":"string","description":"Human-readable name for the asset. For function assets (`type: function`), this should be the NX function name (for example, `nx:layer-autoscale`).","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.name","typeLabel":"string"},"conform":{"type":"boolean","description":"When true for video, image, or audio assets, the worker normalizes the downloaded media to a render-engine-safe target format before assembly. If omitted, the API auto-enables conform for known risky inputs such as WebM, WebP, GIF, and OGG/OGA sources. GIF inputs are converted to a ProRes 4444 MOV file and treated as video.","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.conform","typeLabel":"boolean"},"params":{"type":"object","description":"Optional parameters for function assets. For supported NX layer functions (`nx:layer-autoscale`, `nx:layer-duration-set`, `nx:layer-start-set`, `nx:layer-state-set`, `nx:solid-color-set`, `nx:text-params-set`), `params.layerName` accepts a single string or an array of strings. When an array is provided, the API expands the function asset into multiple per-layer assets while preserving the original `assets` order.","properties":{"layerName":{"oneOf":[{"type":"string","description":"Target layer name(s) for function assets","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.params.layerName.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.params.layerName.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Target layer name(s) for function assets","minItems":1,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.params.layerName.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.params.layerName","typeLabel":"string | string[]"}},"additionalProperties":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0.params","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX].oneOf.0","typeLabel":"object"},{}],"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets.items.[INDEX]","typeLabel":"object"},"description":"Assets to inject into the child job, nested job assets included","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.assets","typeLabel":"object[]"},"preview":{"type":"boolean","default":false,"description":"Generate preview quality for the child job","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.preview","typeLabel":"boolean"},"settings":{"type":"object","description":"Render settings for the child job","properties":{"type":{"type":"string","enum":["video","image"],"default":"video","description":"Output type for the child job","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings.type","typeLabel":"enum\u003cstring>"},"frames":{"oneOf":[{"type":"integer","description":"Frame specification for image output","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings.frames.oneOf.0","typeLabel":"integer"},{"type":"array","items":{"type":"integer","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings.frames.oneOf.1.items.[INDEX]","typeLabel":"integer"},"description":"Frame specification for image output","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings.frames.oneOf.1","typeLabel":"integer[]"}],"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings.frames","typeLabel":"integer | integer[]"},"quality":{"type":"string","enum":["draft","full"],"description":"Render quality","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings.quality","typeLabel":"enum\u003cstring>"},"codec":{"type":"string","description":"Output codec","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings.codec","typeLabel":"string"},"engine":{"type":"string","enum":["ae2025","ae2026"],"default":"ae2026","description":"After Effects render engine version for the child job","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings.engine","typeLabel":"enum\u003cstring>"},"multiFrame":{"type":"boolean","description":"Turn After Effects Multi-Frame Rendering on (true) or off (false) for the child job. If omitted, the worker's own setting applies","uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings.multiFrame","typeLabel":"boolean"}},"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1.settings","typeLabel":"object"}},"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"jobs.items.[INDEX].assets.items.[INDEX]","typeLabel":"object"},"default":[],"description":"Collection of media assets (images, videos, audio, scripts, text) or nested job assets (type: 'job') to use in the render. Nested job assets render as child jobs first, with output injected into the parent composition. For supported NX layer functions, `params.layerName` can be a string or an array of strings; array values are expanded in place while preserving asset order.","uniqueKey":"jobs.items.[INDEX].assets","typeLabel":"object[]"},"settings":{"type":"object","description":"Render configuration settings for output format, quality, and frame selection","properties":{"type":{"type":"string","enum":["video","image","aep","lottie"],"description":"Output render type - 'video' for MP4/MOV files, 'image' for PNG/JPG files, 'aep' for full archive, 'lottie' for a zip of a Lottie export (the team needs Lottie access)","uniqueKey":"jobs.items.[INDEX].settings.type","typeLabel":"enum\u003cstring>"},"frames":{"oneOf":[{"type":"integer","description":"Frame specification - single frame number, [start, end] range or [start, end, skip]. Required for image type unless an nx:preview image function names the frame.","minimum":0,"uniqueKey":"jobs.items.[INDEX].settings.frames.oneOf.0","typeLabel":"integer"},{"type":"array","items":{"type":"integer","minimum":-1,"uniqueKey":"jobs.items.[INDEX].settings.frames.oneOf.1.items.[INDEX]","typeLabel":"integer"},"description":"Frame specification - single frame number, [start, end] range or [start, end, skip]. Required for image type unless an nx:preview image function names the frame.","maxItems":3,"minItems":2,"uniqueKey":"jobs.items.[INDEX].settings.frames.oneOf.1","typeLabel":"integer[]"}],"uniqueKey":"jobs.items.[INDEX].settings.frames","typeLabel":"integer | integer[]"},"quality":{"type":"string","enum":["draft","full"],"description":"Render quality setting - 'draft' for faster low-quality preview, 'full' for high-quality output","uniqueKey":"jobs.items.[INDEX].settings.quality","typeLabel":"enum\u003cstring>"},"codec":{"type":"string","description":"Output codec specification (e.g., 'h264_vbr_15mbps', 'prores_422', 'png', 'jpeg')","uniqueKey":"jobs.items.[INDEX].settings.codec","typeLabel":"string"},"engine":{"type":"string","enum":["ae2025","ae2026"],"default":"ae2026","description":"After Effects render engine version used when the job is picked up by a worker","uniqueKey":"jobs.items.[INDEX].settings.engine","typeLabel":"enum\u003cstring>"},"multiFrame":{"type":"boolean","description":"Turn After Effects Multi-Frame Rendering on (true) or off (false) for this job. If omitted, the worker's own setting applies","uniqueKey":"jobs.items.[INDEX].settings.multiFrame","typeLabel":"boolean"},"lottie":{"type":"object","description":"Bodymovin settings for a 'lottie' job, e.g. export_modes, should_encode_images, rasterize_text. Only some settings can be changed; see the Lottie docs. Not allowed with other types.","additionalProperties":true,"uniqueKey":"jobs.items.[INDEX].settings.lottie","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"jobs.items.[INDEX].settings","typeLabel":"object"},"upload":{"type":"object","description":"Custom upload configuration for output files to external storage providers","properties":{"prefix":{"type":"string","description":"Folder prefix/path where output files will be stored (e.g., 'my-project/outputs/')","uniqueKey":"jobs.items.[INDEX].upload.prefix","typeLabel":"string"},"outputUrl":{"type":"string","description":"Custom base URL for accessing uploaded files publicly","uniqueKey":"jobs.items.[INDEX].upload.outputUrl","typeLabel":"string"},"provider":{"type":"string","enum":["s3"],"default":"s3","description":"Storage provider - 's3' for Amazon S3 compatible","uniqueKey":"jobs.items.[INDEX].upload.provider","typeLabel":"enum\u003cstring>"},"params":{"type":"object","description":"Provider-specific upload parameters and credentials","properties":{"region":{"type":"string","description":"AWS region or storage region identifier (required)","isRequired":true,"uniqueKey":"jobs.items.[INDEX].upload.params.region","typeLabel":"string"},"bucket":{"type":"string","description":"Target bucket name for file uploads (required)","isRequired":true,"uniqueKey":"jobs.items.[INDEX].upload.params.bucket","typeLabel":"string"},"accessKeyId":{"type":"string","description":"AWS access key ID or equivalent credential (required)","isRequired":true,"uniqueKey":"jobs.items.[INDEX].upload.params.accessKeyId","typeLabel":"string"},"accessKeySecret":{"type":"string","description":"AWS secret access key or equivalent credential (required)","isRequired":true,"uniqueKey":"jobs.items.[INDEX].upload.params.accessKeySecret","typeLabel":"string"},"endpoint":{"type":"string","default":"https://s3.amazonaws.com","description":"Public HTTP(S) S3-compatible endpoint URL. Explicit customer credentials are required; worker credentials are not used for arbitrary endpoints.","uniqueKey":"jobs.items.[INDEX].upload.params.endpoint","typeLabel":"string"},"acl":{"type":"string","description":"Access control list setting for uploaded files (e.g., 'public-read', 'private')","uniqueKey":"jobs.items.[INDEX].upload.params.acl","typeLabel":"string"}},"required":["region","bucket","accessKeyId","accessKeySecret"],"additionalProperties":false,"uniqueKey":"jobs.items.[INDEX].upload.params","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"jobs.items.[INDEX].upload","typeLabel":"object"},"webhook":{"type":"object","description":"Webhook configuration for job status notifications and callbacks","properties":{"url":{"type":"string","description":"Target webhook URL that will receive job status updates","isRequired":true,"uniqueKey":"jobs.items.[INDEX].webhook.url","typeLabel":"string"},"method":{"type":"string","enum":["GET","POST","PUT","DELETE"],"description":"HTTP method to use when calling the webhook endpoint","default":"POST","uniqueKey":"jobs.items.[INDEX].webhook.method","typeLabel":"enum\u003cstring>"},"headers":{"type":"object","description":"Additional HTTP headers to include in webhook requests","additionalProperties":true,"uniqueKey":"jobs.items.[INDEX].webhook.headers","typeLabel":"object"},"data":{"type":"object","description":"Custom data payload to include with webhook notifications","additionalProperties":true,"uniqueKey":"jobs.items.[INDEX].webhook.data","typeLabel":"object"},"custom":{"type":"boolean","default":false,"description":"Flag indicating if webhook should only include custom data provided by the user","uniqueKey":"jobs.items.[INDEX].webhook.custom","typeLabel":"boolean"}},"required":["url"],"uniqueKey":"jobs.items.[INDEX].webhook","typeLabel":"object"}},"required":["template"],"additionalProperties":true,"uniqueKey":"jobs.items.[INDEX]","typeLabel":"object"},"minItems":1,"maxItems":1000,"isRequired":true,"uniqueKey":"jobs","typeLabel":"object[]"},"batchId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$","description":"Optional client-chosen ULID that makes the request safe to retry. Sending a batch again with the same batchId creates only the jobs that are not in it yet: the response is 200 with status 'replayed' when nothing was missing, or 'partial' when the missing jobs were created. Retries are recognised for 30 days, while the batch's jobs are kept. Requests with the same batchId must not run at the same time: two that overlap on the server can both create jobs. A timeout on your side does not mean the server stopped processing, so after a timeout wait until GET /batches/{id} stops changing before retrying. Without it the API generates one, and a retry creates a new batch.","uniqueKey":"batchId","typeLabel":"string"}},"required":["jobs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"jobs":[{"template":{"id":"\u003cstring>","src":"\u003cstring>","name":"\u003cstring>","composition":"\u003cstring>"},"preview":false,"fonts":[],"assets":[],"settings":{"frames":1,"codec":"\u003cstring>","engine":"ae2026","multiFrame":true,"lottie":{}},"upload":{"prefix":"\u003cstring>","outputUrl":"\u003cstring>","provider":"s3"}}],"batchId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1e231449-4510-4b6c-a478-b95d3ed8c8af":{"description":"A retry with an existing batchId. Status 'replayed' when every job already existed, 'partial' when the missing jobs were created now.","content":{"application/json":{"schema":{"type":"object","description":"Response after creating a batch of jobs, including per-job results and any errors","properties":{"batchId":{"type":"string","description":"Unique batch identifier in ULID format for tracking the entire batch","isRequired":true,"uniqueKey":"batchId","typeLabel":"string"},"status":{"type":"string","enum":["created","partial","error","replayed"],"description":"'created' if all jobs succeeded, 'partial' if some failed or a retry created only the missing jobs, 'error' if all failed, 'replayed' if a retry with the same batchId found every job already created","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"totalJobs":{"type":"integer","description":"Total number of jobs in the batch request","isRequired":true,"uniqueKey":"totalJobs","typeLabel":"integer"},"successCount":{"type":"integer","description":"Number of successfully created jobs","isRequired":true,"uniqueKey":"successCount","typeLabel":"integer"},"jobs":{"type":"array","description":"Array of successfully created job details","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of this job in the original request array","uniqueKey":"jobs.items.[INDEX].index","typeLabel":"integer"},"id":{"type":"string","description":"Unique job identifier","uniqueKey":"jobs.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","description":"Initial job status ('queued' or 'pending' for parent jobs)","uniqueKey":"jobs.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","description":"URL where the rendered output will be available","uniqueKey":"jobs.items.[INDEX].outputUrl","typeLabel":"string"},"children":{"type":"array","description":"Child job details (only present for jobs with nested job assets)","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].outputUrl","typeLabel":"string"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX]","typeLabel":"object"},"uniqueKey":"jobs.items.[INDEX].children","typeLabel":"object[]"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"description":"Fonts referenced in template but not found in team's font library","uniqueKey":"jobs.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"jobs","typeLabel":"object[]"},"error":{"type":"string","description":"Present on 409 and 503 responses: why the batch could not be completed","uniqueKey":"error","typeLabel":"string"},"errorCode":{"type":"string","description":"Present on 409 and 503 responses, for example BATCH_ALREADY_PARTIAL or BATCH_RETRYABLE","uniqueKey":"errorCode","typeLabel":"string"},"errors":{"type":"array","description":"Array of errors for failed jobs (only present when status is 'partial' or 'error')","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of the failed job in the original request array","uniqueKey":"errors.items.[INDEX].index","typeLabel":"integer"},"error":{"type":"string","description":"Error message describing why the job failed","uniqueKey":"errors.items.[INDEX].error","typeLabel":"string"},"errorCode":{"type":"string","description":"Machine-readable error code","uniqueKey":"errors.items.[INDEX].errorCode","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["batchId","status","totalJobs","successCount","jobs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"batchId":"\u003cstring>","status":"created","totalJobs":123,"successCount":123,"jobs":[{"index":123,"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","children":[{"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","missingFonts":["\u003cstring>"]}],"missingFonts":["\u003cstring>"]}],"error":"\u003cstring>","errorCode":"\u003cstring>","errors":[{"index":123,"error":"\u003cstring>","errorCode":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"b9dd2d62-4197-46e4-9cd6-3b46b32cc329":{"description":"Batch created successfully. Check 'status' field: 'created' means all jobs succeeded, 'partial' means some failed (see 'errors' array).","content":{"application/json":{"schema":{"type":"object","description":"Response after creating a batch of jobs, including per-job results and any errors","properties":{"batchId":{"type":"string","description":"Unique batch identifier in ULID format for tracking the entire batch","isRequired":true,"uniqueKey":"batchId","typeLabel":"string"},"status":{"type":"string","enum":["created","partial","error","replayed"],"description":"'created' if all jobs succeeded, 'partial' if some failed or a retry created only the missing jobs, 'error' if all failed, 'replayed' if a retry with the same batchId found every job already created","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"totalJobs":{"type":"integer","description":"Total number of jobs in the batch request","isRequired":true,"uniqueKey":"totalJobs","typeLabel":"integer"},"successCount":{"type":"integer","description":"Number of successfully created jobs","isRequired":true,"uniqueKey":"successCount","typeLabel":"integer"},"jobs":{"type":"array","description":"Array of successfully created job details","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of this job in the original request array","uniqueKey":"jobs.items.[INDEX].index","typeLabel":"integer"},"id":{"type":"string","description":"Unique job identifier","uniqueKey":"jobs.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","description":"Initial job status ('queued' or 'pending' for parent jobs)","uniqueKey":"jobs.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","description":"URL where the rendered output will be available","uniqueKey":"jobs.items.[INDEX].outputUrl","typeLabel":"string"},"children":{"type":"array","description":"Child job details (only present for jobs with nested job assets)","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].outputUrl","typeLabel":"string"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX]","typeLabel":"object"},"uniqueKey":"jobs.items.[INDEX].children","typeLabel":"object[]"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"description":"Fonts referenced in template but not found in team's font library","uniqueKey":"jobs.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"jobs","typeLabel":"object[]"},"error":{"type":"string","description":"Present on 409 and 503 responses: why the batch could not be completed","uniqueKey":"error","typeLabel":"string"},"errorCode":{"type":"string","description":"Present on 409 and 503 responses, for example BATCH_ALREADY_PARTIAL or BATCH_RETRYABLE","uniqueKey":"errorCode","typeLabel":"string"},"errors":{"type":"array","description":"Array of errors for failed jobs (only present when status is 'partial' or 'error')","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of the failed job in the original request array","uniqueKey":"errors.items.[INDEX].index","typeLabel":"integer"},"error":{"type":"string","description":"Error message describing why the job failed","uniqueKey":"errors.items.[INDEX].error","typeLabel":"string"},"errorCode":{"type":"string","description":"Machine-readable error code","uniqueKey":"errors.items.[INDEX].errorCode","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["batchId","status","totalJobs","successCount","jobs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"batchId":"\u003cstring>","status":"created","totalJobs":123,"successCount":123,"jobs":[{"index":123,"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","children":[{"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","missingFonts":["\u003cstring>"]}],"missingFonts":["\u003cstring>"]}],"error":"\u003cstring>","errorCode":"\u003cstring>","errors":[{"index":123,"error":"\u003cstring>","errorCode":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"ccdcf50b-0baf-4267-a3a9-3db537ef506c":{"description":"Invalid request (including INVALID_BATCH_ID) or all jobs in the batch failed","content":{"application/json":{"schema":{"type":"object","description":"Response after creating a batch of jobs, including per-job results and any errors","properties":{"batchId":{"type":"string","description":"Unique batch identifier in ULID format for tracking the entire batch","isRequired":true,"uniqueKey":"batchId","typeLabel":"string"},"status":{"type":"string","enum":["created","partial","error","replayed"],"description":"'created' if all jobs succeeded, 'partial' if some failed or a retry created only the missing jobs, 'error' if all failed, 'replayed' if a retry with the same batchId found every job already created","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"totalJobs":{"type":"integer","description":"Total number of jobs in the batch request","isRequired":true,"uniqueKey":"totalJobs","typeLabel":"integer"},"successCount":{"type":"integer","description":"Number of successfully created jobs","isRequired":true,"uniqueKey":"successCount","typeLabel":"integer"},"jobs":{"type":"array","description":"Array of successfully created job details","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of this job in the original request array","uniqueKey":"jobs.items.[INDEX].index","typeLabel":"integer"},"id":{"type":"string","description":"Unique job identifier","uniqueKey":"jobs.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","description":"Initial job status ('queued' or 'pending' for parent jobs)","uniqueKey":"jobs.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","description":"URL where the rendered output will be available","uniqueKey":"jobs.items.[INDEX].outputUrl","typeLabel":"string"},"children":{"type":"array","description":"Child job details (only present for jobs with nested job assets)","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].outputUrl","typeLabel":"string"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX]","typeLabel":"object"},"uniqueKey":"jobs.items.[INDEX].children","typeLabel":"object[]"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"description":"Fonts referenced in template but not found in team's font library","uniqueKey":"jobs.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"jobs","typeLabel":"object[]"},"error":{"type":"string","description":"Present on 409 and 503 responses: why the batch could not be completed","uniqueKey":"error","typeLabel":"string"},"errorCode":{"type":"string","description":"Present on 409 and 503 responses, for example BATCH_ALREADY_PARTIAL or BATCH_RETRYABLE","uniqueKey":"errorCode","typeLabel":"string"},"errors":{"type":"array","description":"Array of errors for failed jobs (only present when status is 'partial' or 'error')","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of the failed job in the original request array","uniqueKey":"errors.items.[INDEX].index","typeLabel":"integer"},"error":{"type":"string","description":"Error message describing why the job failed","uniqueKey":"errors.items.[INDEX].error","typeLabel":"string"},"errorCode":{"type":"string","description":"Machine-readable error code","uniqueKey":"errors.items.[INDEX].errorCode","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["batchId","status","totalJobs","successCount","jobs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"batchId":"\u003cstring>","status":"created","totalJobs":123,"successCount":123,"jobs":[{"index":123,"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","children":[{"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","missingFonts":["\u003cstring>"]}],"missingFonts":["\u003cstring>"]}],"error":"\u003cstring>","errorCode":"\u003cstring>","errors":[{"index":123,"error":"\u003cstring>","errorCode":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"78015434-1207-471b-bac2-c8303171f754":{"description":"Unauthorized - invalid or missing API token","content":{"application/json":{"schema":{"type":"object","description":"Standard error response format","properties":{"error":{"type":"string","description":"Human-readable error message explaining what went wrong","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"31ca256c-840d-408f-b6fb-ba488ca106a8":{"description":"Forbidden - license is not valid","content":{"application/json":{"schema":{"type":"object","description":"Standard error response format","properties":{"error":{"type":"string","description":"Human-readable error message explaining what went wrong","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e2f8959d-4040-40d4-9be8-0174f967007a":{"description":"BATCH_ALREADY_PARTIAL: a retry with an existing batchId could not reconcile the jobs already in the batch with the request.","content":{"application/json":{"schema":{"type":"object","description":"Response after creating a batch of jobs, including per-job results and any errors","properties":{"batchId":{"type":"string","description":"Unique batch identifier in ULID format for tracking the entire batch","isRequired":true,"uniqueKey":"batchId","typeLabel":"string"},"status":{"type":"string","enum":["created","partial","error","replayed"],"description":"'created' if all jobs succeeded, 'partial' if some failed or a retry created only the missing jobs, 'error' if all failed, 'replayed' if a retry with the same batchId found every job already created","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"totalJobs":{"type":"integer","description":"Total number of jobs in the batch request","isRequired":true,"uniqueKey":"totalJobs","typeLabel":"integer"},"successCount":{"type":"integer","description":"Number of successfully created jobs","isRequired":true,"uniqueKey":"successCount","typeLabel":"integer"},"jobs":{"type":"array","description":"Array of successfully created job details","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of this job in the original request array","uniqueKey":"jobs.items.[INDEX].index","typeLabel":"integer"},"id":{"type":"string","description":"Unique job identifier","uniqueKey":"jobs.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","description":"Initial job status ('queued' or 'pending' for parent jobs)","uniqueKey":"jobs.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","description":"URL where the rendered output will be available","uniqueKey":"jobs.items.[INDEX].outputUrl","typeLabel":"string"},"children":{"type":"array","description":"Child job details (only present for jobs with nested job assets)","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].outputUrl","typeLabel":"string"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX]","typeLabel":"object"},"uniqueKey":"jobs.items.[INDEX].children","typeLabel":"object[]"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"description":"Fonts referenced in template but not found in team's font library","uniqueKey":"jobs.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"jobs","typeLabel":"object[]"},"error":{"type":"string","description":"Present on 409 and 503 responses: why the batch could not be completed","uniqueKey":"error","typeLabel":"string"},"errorCode":{"type":"string","description":"Present on 409 and 503 responses, for example BATCH_ALREADY_PARTIAL or BATCH_RETRYABLE","uniqueKey":"errorCode","typeLabel":"string"},"errors":{"type":"array","description":"Array of errors for failed jobs (only present when status is 'partial' or 'error')","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of the failed job in the original request array","uniqueKey":"errors.items.[INDEX].index","typeLabel":"integer"},"error":{"type":"string","description":"Error message describing why the job failed","uniqueKey":"errors.items.[INDEX].error","typeLabel":"string"},"errorCode":{"type":"string","description":"Machine-readable error code","uniqueKey":"errors.items.[INDEX].errorCode","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["batchId","status","totalJobs","successCount","jobs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"batchId":"\u003cstring>","status":"created","totalJobs":123,"successCount":123,"jobs":[{"index":123,"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","children":[{"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","missingFonts":["\u003cstring>"]}],"missingFonts":["\u003cstring>"]}],"error":"\u003cstring>","errorCode":"\u003cstring>","errors":[{"index":123,"error":"\u003cstring>","errorCode":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"59403a01-4f97-4c50-9096-b54ee3140161":{"description":"BATCH_RETRYABLE: the database was briefly unavailable part-way through. The jobs created so far are listed. Retry with the same batchId after Retry-After seconds to create only the rest.","headers":{"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","description":"Response after creating a batch of jobs, including per-job results and any errors","properties":{"batchId":{"type":"string","description":"Unique batch identifier in ULID format for tracking the entire batch","isRequired":true,"uniqueKey":"batchId","typeLabel":"string"},"status":{"type":"string","enum":["created","partial","error","replayed"],"description":"'created' if all jobs succeeded, 'partial' if some failed or a retry created only the missing jobs, 'error' if all failed, 'replayed' if a retry with the same batchId found every job already created","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"totalJobs":{"type":"integer","description":"Total number of jobs in the batch request","isRequired":true,"uniqueKey":"totalJobs","typeLabel":"integer"},"successCount":{"type":"integer","description":"Number of successfully created jobs","isRequired":true,"uniqueKey":"successCount","typeLabel":"integer"},"jobs":{"type":"array","description":"Array of successfully created job details","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of this job in the original request array","uniqueKey":"jobs.items.[INDEX].index","typeLabel":"integer"},"id":{"type":"string","description":"Unique job identifier","uniqueKey":"jobs.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","description":"Initial job status ('queued' or 'pending' for parent jobs)","uniqueKey":"jobs.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","description":"URL where the rendered output will be available","uniqueKey":"jobs.items.[INDEX].outputUrl","typeLabel":"string"},"children":{"type":"array","description":"Child job details (only present for jobs with nested job assets)","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].status","typeLabel":"string"},"outputUrl":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].outputUrl","typeLabel":"string"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX].children.items.[INDEX]","typeLabel":"object"},"uniqueKey":"jobs.items.[INDEX].children","typeLabel":"object[]"},"missingFonts":{"type":"array","items":{"type":"string","uniqueKey":"jobs.items.[INDEX].missingFonts.items.[INDEX]","typeLabel":"string"},"description":"Fonts referenced in template but not found in team's font library","uniqueKey":"jobs.items.[INDEX].missingFonts","typeLabel":"string[]"}},"uniqueKey":"jobs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"jobs","typeLabel":"object[]"},"error":{"type":"string","description":"Present on 409 and 503 responses: why the batch could not be completed","uniqueKey":"error","typeLabel":"string"},"errorCode":{"type":"string","description":"Present on 409 and 503 responses, for example BATCH_ALREADY_PARTIAL or BATCH_RETRYABLE","uniqueKey":"errorCode","typeLabel":"string"},"errors":{"type":"array","description":"Array of errors for failed jobs (only present when status is 'partial' or 'error')","items":{"type":"object","properties":{"index":{"type":"integer","description":"Position of the failed job in the original request array","uniqueKey":"errors.items.[INDEX].index","typeLabel":"integer"},"error":{"type":"string","description":"Error message describing why the job failed","uniqueKey":"errors.items.[INDEX].error","typeLabel":"string"},"errorCode":{"type":"string","description":"Machine-readable error code","uniqueKey":"errors.items.[INDEX].errorCode","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["batchId","status","totalJobs","successCount","jobs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"batchId":"\u003cstring>","status":"created","totalJobs":123,"successCount":123,"jobs":[{"index":123,"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","children":[{"id":"\u003cstring>","status":"\u003cstring>","outputUrl":"\u003cstring>","missingFonts":["\u003cstring>"]}],"missingFonts":["\u003cstring>"]}],"error":"\u003cstring>","errorCode":"\u003cstring>","errors":[{"index":123,"error":"\u003cstring>","errorCode":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9409df23-e540-4851-a6b9-305f5ba80c53":{"apiToken":{"type":"http","scheme":"bearer","description":"Bearer token authentication using API tokens for team-based access control.\n\nYou can generate your own API token at: https://app.nexrender.com/settings/api-tokens\n","scopes":[],"schemeName":"apiToken"}}},"servers":{"4133949a-4c35-4adc-be73-807c1d304960":{"url":"https://api.nexrender.com/api/v2","description":"Production API server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer token authentication using API tokens for team-based access control.\n\nYou can generate your own API token at: https://app.nexrender.com/settings/api-tokens\n","scopes":[],"schemeName":"apiToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token authentication using API tokens for team-based access control.\n\nYou can generate your own API token at: https://app.nexrender.com/settings/api-tokens\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiToken","name":"Authorization"}],"title":"apiToken"}]},"originalFileLocation":"openapi.json"},"subdomain":"nexrender","siteName":"Nexrender Cloud Documentation","title":"Create batch of jobs - Nexrender Cloud Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T11:09:23.377Z","originalFileLocation":"api-reference/batch-management/create-batch-of-jobs.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nexrender Cloud Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create batch of jobs - Nexrender Cloud Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nexrender Cloud Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nexrender.mintlify.site/docs/_mintlify/api/og/v2?division=Batch+Jobs\u0026amp;title=Create+batch+of+jobs\u0026amp;description=Submit+multiple+render+jobs+in+a+single+request.+Each+job+in+the+batch+follows+the+same+schema+as+a+single+job+creation.+Supports+partial+success+-+some+jobs+ma\u0026amp;theme=9b3a9b6702e62956ce09a26f\u0026amp;signature=467a2abdbb0ecaf74b778c82ac8c1fe65863254bc611c6821d40c91e19f3043e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create batch of jobs - Nexrender Cloud Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nexrender.mintlify.site/docs/_mintlify/api/og/v2?division=Batch+Jobs\u0026amp;title=Create+batch+of+jobs\u0026amp;description=Submit+multiple+render+jobs+in+a+single+request.+Each+job+in+the+batch+follows+the+same+schema+as+a+single+job+creation.+Supports+partial+success+-+some+jobs+ma\u0026amp;theme=9b3a9b6702e62956ce09a26f\u0026amp;signature=467a2abdbb0ecaf74b778c82ac8c1fe65863254bc611c6821d40c91e19f3043e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/nexrender/VfYtARxiRd08ZM8o/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nexrender Cloud Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A06BC6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/batch-management/create-batch-of-jobs.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.nexrender.com/#organization\",\"name\":\"Nexrender Cloud Documentation\",\"url\":\"https://www.nexrender.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nexrender/hhU8sut1bRm3T6o4/logo/nx-text-logo-dark.png?fit=max\u0026auto=format\u0026n=hhU8sut1bRm3T6o4\u0026q=85\u0026s=dfd4191163c2c6667fef64145f151792\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.nexrender.com/docs#website\",\"name\":\"Nexrender Cloud Documentation\",\"url\":\"https://www.nexrender.com/docs\",\"publisher\":{\"@id\":\"https://www.nexrender.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs#webpage\",\"url\":\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs\",\"name\":\"Create batch of jobs\",\"description\":\"Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.\",\"dateModified\":\"2026-11-07T11:09:23.377Z\",\"isPartOf\":{\"@id\":\"https://www.nexrender.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Nexrender Cloud Documentation\",\"item\":\"https://www.nexrender.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create batch of jobs\",\"item\":\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs#apireference\",\"headline\":\"Create batch of jobs\",\"name\":\"Create batch of jobs\",\"description\":\"Submit multiple render jobs in a single request. Each job in the batch follows the same schema as a single job creation. Supports partial success - some jobs may succeed while others fail.\",\"url\":\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs\",\"mainEntityOfPage\":{\"@id\":\"https://www.nexrender.com/docs/api-reference/batch-management/create-batch-of-jobs#webpage\"},\"dateModified\":\"2026-11-07T11:09:23.377Z\",\"publisher\":{\"@id\":\"https://www.nexrender.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.nexrender.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nexrender Cloud Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Nexrender Cloud Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/batch-management/create-batch-of-jobs.md","siteName":"Nexrender Cloud Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/cloud/introduction"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Templates Management","pages":[{"title":"List all templates (deprecated)","deprecated":true,"version":null,"openapi":"/openapi.json get /templates","href":"/api-reference/template-management/list-all-templates-deprecated"},{"title":"List templates (v3)","deprecated":null,"version":null,"openapi":"/openapi.json get /v3/templates","href":"/api-reference/template-management/list-templates-v3"},{"title":"Create new template","deprecated":null,"version":null,"openapi":"/openapi.json post /templates","href":"/api-reference/template-management/create-new-template"},{"title":"Get template details","deprecated":null,"version":null,"openapi":"/openapi.json get /templates/{id}","href":"/api-reference/template-management/get-template-details"},{"title":"Get template metadata (v3)","deprecated":null,"version":null,"openapi":"/openapi.json get /v3/templates/{id}","href":"/api-reference/template-management/get-template-metadata-v3"},{"title":"List template compositions (v3)","deprecated":null,"version":null,"openapi":"/openapi.json get /v3/templates/{id}/compositions","href":"/api-reference/template-management/list-template-compositions-v3"},{"title":"List template layers (v3)","deprecated":null,"version":null,"openapi":"/openapi.json get /v3/templates/{id}/layers","href":"/api-reference/template-management/list-template-layers-v3"},{"title":"Update template","deprecated":null,"version":null,"openapi":"/openapi.json patch /templates/{id}","href":"/api-reference/template-management/update-template"},{"title":"Delete template","deprecated":null,"version":null,"openapi":"/openapi.json delete /templates/{id}","href":"/api-reference/template-management/delete-template"},{"title":"Get download URL for template file","deprecated":null,"version":null,"openapi":"/openapi.json get /templates/{id}/download","href":"/api-reference/template-management/get-download-url-for-template-file"},{"title":"Get fresh upload URL for template file","deprecated":null,"version":null,"openapi":"/openapi.json put /templates/{id}/upload","href":"/api-reference/template-management/get-fresh-upload-url-for-template-file"}]},{"group":"Rendering Jobs","pages":[{"title":"List jobs","deprecated":null,"version":null,"openapi":"/openapi.json get /jobs","href":"/api-reference/render-management/list-jobs"},{"title":"Create new job","deprecated":null,"version":null,"openapi":"/openapi.json post /jobs","href":"/api-reference/render-management/create-new-job"},{"title":"Cancel multiple jobs","deprecated":null,"version":null,"openapi":"/openapi.json post /jobs/cancel","href":"/api-reference/render-management/cancel-multiple-jobs"},{"title":"Create join/stitch job","deprecated":null,"version":null,"openapi":"/openapi.json post /jobs/join","href":"/api-reference/render-management/create-joinstitch-job"},{"title":"Get job details","deprecated":null,"version":null,"openapi":"/openapi.json get /jobs/{id}","href":"/api-reference/render-management/get-job-details"},{"title":"Get job render logs","deprecated":null,"version":null,"openapi":"/openapi.json get /jobs/{id}/logs","href":"/api-reference/render-management/get-job-render-logs"},{"title":"Cancel job","description":"Cancel a single job by ID. The requested job must be in a cancellable state. Related parent, child, or sibling jobs discovered through nesting are cancelled on a best-effort basis and included in the response, including sibling cascades from child cancellation.","deprecated":null,"version":null,"openapi":"/openapi.json patch /jobs/{id}/cancel","href":"/api-reference/render-management/cancel-job"}]},{"group":"Batch Jobs","pages":[{"title":"Create batch of jobs","deprecated":null,"version":null,"openapi":"/openapi.json post /batches","href":"/api-reference/batch-management/create-batch-of-jobs"},{"title":"Get batch status","description":"Retrieve the current status and progress of a batch of jobs, including aggregate statistics and per-job details","deprecated":null,"version":null,"openapi":"/openapi.json get /batches/{id}","href":"/api-reference/batch-management/get-batch-status"},{"title":"Cancel batch jobs","deprecated":null,"version":null,"openapi":"/openapi.json post /batches/{id}/cancel","href":"/api-reference/batch-management/cancel-batch-jobs"}]},{"group":"Fonts Management","pages":[{"title":"List all fonts for team","deprecated":null,"version":null,"openapi":"/openapi.json get /fonts","href":"/api-reference/font-management/list-all-fonts-for-team"},{"title":"Upload new font","deprecated":null,"version":null,"openapi":"/openapi.json post /fonts","href":"/api-reference/font-management/upload-new-font"},{"title":"Get font metadata","deprecated":null,"version":null,"openapi":"/openapi.json get /fonts/{id}","href":"/api-reference/font-management/get-font-metadata"},{"title":"Delete font","deprecated":null,"version":null,"openapi":"/openapi.json delete /fonts/{id}","href":"/api-reference/font-management/delete-font"}]},{"group":"Secrets Management","pages":[{"title":"List all secrets","deprecated":null,"version":null,"openapi":"/openapi.json get /secrets","href":"/api-reference/secret-management/list-all-secrets"},{"title":"Create a new secret","deprecated":null,"version":null,"openapi":"/openapi.json put /secrets","href":"/api-reference/secret-management/create-a-new-secret"},{"title":"Delete secret","deprecated":null,"version":null,"openapi":"/openapi.json delete /secrets/{id}","href":"/api-reference/secret-management/delete-secret"}]},{"group":"Team","pages":[{"title":"Get your team","deprecated":null,"version":null,"openapi":"/openapi.json get /team","href":"/api-reference/team/get-your-team"}]}]},{"tab":"Changelog","icon":"history","pages":[{"title":"Changelog","href":"/cloud/changelog"}]}]},"basePath":"","title":"Create batch of jobs - Nexrender Cloud Documentation","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}