Cancel a Render Job

Cancel an async render job that has not started yet. Running renders complete and bill normally.

Updated


Cancel an async render job that is still queued.

POST https://api.orshot.com/v1/studio/render-jobs/:id/cancel

Only queued jobs can be canceled: nothing has rendered, so nothing is billed. The response is the job object with status: "canceled".

When cancel is refused#

Job stateResponseMeaning
processing409 job-not-cancelableThe render is already running. It completes and is billed normally; poll it, or simply ignore the result.
succeeded / failed / canceled409 job-already-finishedThe job already finished; there is nothing to cancel.
not in your workspace404 job-not-foundUnknown id (job ids are workspace-scoped).

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key
  • Image, PDF and video generation via API
  • Visual editor with AI and smart layouts
  • Zapier, Make, MCP and 50+ integrations
  • White-label embed for your own app
  • 30 free credits — no credit card required