Retrieve a render

A render's status and, once it is completed, its image. Fetch it again for a fresh image link.

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

Updated

Poll this until the render’s status is completed, failed or cancelled. Fetch it again later for a fresh image link. Reading a render is free.

Request

idstring, pathrequired

The render’s id, a UUID, as returned by Create renders.

Response

render: a Render. While it is being made, image_url is null; once it is completed, it links to the image. A failed render says why in error, and its credit has been given back.

Errors

StatusTypeWhen
401authentication_requiredNo key was sent.
401invalid_api_keyThe key is not valid or was revoked.
404not_foundNo render with that id in your workspace, or the id is not a UUID.
429rate_limitedToo many requests this minute. Poll less often.

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