Cancel a render

Cancel a render that has not started yet, and get its credit back if your credits have not renewed since.

DELETEhttps://www.skipshoot.com/api/v1/renders/{id}

Updated October 28, 2026

On this page

Request
Response
Refunds
Errors

Cancels a render that is still queued. A render that has started carries on and cannot be cancelled.

Request

idstring, pathrequired: The render’s id.

Response

render: the Render, now cancelled.

Refunds

A cancelled render’s credit goes back to your workspace, unless it was taken before your workspace’s credits last renewed; its error then says so. The Terms of service (section 4) set this out.

Errors

Status	Type	When
404	`not_found`	No render with that id in your workspace.
409	`conflict`	The render has already started, or has already finished.
429	`rate_limited`	Too many requests this minute.

See The render lifecycle for when a render leaves the queue.

Request

curl -X DELETE https://www.skipshoot.com/api/v1/renders/3f2b8e9a-6c1d-4e7b-9a05-2d8c41f7b6e0 \
  -H "Authorization: Bearer $SKIPSHOOT_SECRET_KEY"

Response

{
  "render": {
    "id": "3f2b8e9a-6c1d-4e7b-9a05-2d8c41f7b6e0",
    "scene": {
      "id": 812,
      "name": "Library"
    },
    "product": {
      "id": 4410,
      "name": "Emerald velvet"
    },
    "paint": null,
    "surface": "Sofa",
    "created_at": "2026-10-21T14:03:12.000Z",
    "status": "cancelled",
    "image_url": null,
    "upscale_status": "not_requested",
    "error": "Cancelled before it started."
  }
}

Something these pages do not answer? Email admin@skipshoot.com and we’ll help.