# Update existing Workloads

> Update existing Workloads - Replace artifacts, roll out runtime updates, and promote drafts to
> production.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-06-22T16:50:38.254772+00:00` (UTC).

## Primary page

- [Update existing Workloads](https://docs.datarobot.com/en/docs/workload-api/update-workloads/index.html.md): Full documentation for this topic (Markdown sidecar).

## Related documentation

- [Workload API](https://docs.datarobot.com/en/docs/workload-api/index.html.md): Linked from this page.
- [Replace and roll out](https://docs.datarobot.com/en/docs/workload-api/update-workloads/replace-artifact-rollouts.html.md): Linked from this page.
- [Promote to production](https://docs.datarobot.com/en/docs/workload-api/update-workloads/promote-production.html.md): Linked from this page.
- [Tutorial: Replace the artifact behind a running Workload](https://docs.datarobot.com/en/docs/workload-api/update-workloads/tutorial-replace-artifacts.html.md): Linked from this page.
- [REST: Update Workloads](https://docs.datarobot.com/en/docs/workload-api/update-workloads/update-rest-endpoints.html.md): Linked from this page.
- [UI: Update deployed Workloads](https://docs.datarobot.com/en/docs/workload-api/update-workloads/update-ui.html.md): Linked from this page.
- [Operate Workloads](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/index.html.md): Linked from this page.

## Documentation content

> [!NOTE] Preview
> The Workload API is a preview feature, on by default.
> 
> Feature flag: Enable Access to Workload API Experimental Features

Update a Workload when what it runs needs to change—a new artifact version, a new runtime configuration, or a draft graduating to production. The platform handles the swap with no downtime: a candidate proton starts up alongside the active one, traffic shifts onto it, and the previous proton drains.

| Resource | Description |
| --- | --- |
| Replace and roll out | Replace rules, the rolling strategy, candidate protons, replacement status, and history. |
| Promote to production | POST /workloads/{id}/promote—lock the artifact, reset stats, remove the draft TTL (time-to-live), identity preserved. |
| Tutorial: Replace the artifact behind a running Workload | End-to-end rolling replacement walkthrough—swap the artifact backing a live Workload with no endpoint change. |
| REST: Update Workloads | Promote and replacement-history APIs. |
| UI: Update deployed Workloads | Console actions for replace and promote. |

For day-to-day operations (start, stop, settings, sharing), see [Operate Workloads](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/index.html.md).