PATCH Requests

PATCH endpoints (such as Update service) enable you to update details of an existing resource. The following conventions apply to PATCH endpoints in the Render API:

No nested resources

PATCH endpoints are not used for updating nested resources. For example, if you want to manage custom domains for a service, you wouldn't do this through the Update service endpoint, but would instead use the Add custom domain and Delete custom domain endpoints.

What gets updated?

PATCH endpoints update any resource fields that you provide a new value for in your request body. This is true even if a provided value is null/empty. In this case, the endpoint removes or unsets the field for the resource.

Any resource fields you omit entirely from your request body remain unchanged.