Skip to content

Apps · 5 November 2026

App versions and Render deploys

GET /v2/apps/{id}/versions lists an app's versions, newest first and paginated by limit and cursor. GET /v2/app-versions/{id} returns one version. A version is numbered by the app generation that created it, so the response to the PATCH that creates a version identifies it. A new spec.rollout value creates a new version with the same settings. Render's deploy endpoints are now served under /compat/render/v1: list deploys (filterable by status), get a deploy, create a deploy (imageUrl, or a redeploy of the current image), and roll back to an earlier deploy (POST /services/{serviceId}/rollback). A deploy's ID is its version number. Creating a deploy, or changing the image with PATCH /services/{serviceId}, clears an earlier rollback, so the new version goes live. commitId and buildId return 400, and cancelling a deploy is not supported.

Same day.

Cut your cloud billby 75%.

No card to start. Billed by the second after.

Start free, no card