Trigger deploy
render_create_deployTrigger a deploy for a Render service by providing the service ID. Optionally specify a Git commit, image URL, deploy mode, or clear build cache.
Instructions
Trigger deploy. Trigger a deploy for the service with the provided ID. Calls POST /services/{serviceId}/deploys on the Render Public API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| commitId | No | The SHA of a specific Git commit to deploy for a service. Defaults to the latest commit on the service's connected branch. Note that deploying a specific commit with this endpoint does not disable autodeploys for the service. You can toggle autodeploys for your service with the [Update service](https://api-docs.render.com/reference/update-service) endpoint or in the Render Dashboard. Not supported for cron jobs. | |
| imageUrl | No | The URL of the image to deploy for an image-backed service. The host, repository, and image name all must match the currently configured image for the service. | |
| serviceId | Yes | The ID of the service | |
| clearCache | No | If `clear`, Render clears the service's build cache before deploying. This can be useful if you're experiencing issues with your build. | do_not_clear |
| deployMode | No | Deployment mode controlling build and deploy behavior. Defaults to `build_and_deploy` when not specified. **Validation:** `deploy_mode` cannot be combined with `commitId` or `imageUrl` or `clearCache`. | build_and_deploy |