# Update deployed Workloads

> Update deployed Workloads - Promote draft Workloads to production and replace the artifact behind a
> Workload.

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.256011+00:00` (UTC).

## Primary page

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

## Sections on this page

- [Promote a draft Workload](https://docs.datarobot.com/en/docs/workload-api/update-workloads/update-ui.html.md#promote-a-draft-workload): In-page section heading.
- [Replace the artifact behind a Workload](https://docs.datarobot.com/en/docs/workload-api/update-workloads/update-ui.html.md#replace-the-artifact-behind-a-workload): In-page section heading.

## Related documentation

- [Workload API](https://docs.datarobot.com/en/docs/workload-api/index.html.md): Linked from this page.
- [Update existing Workloads](https://docs.datarobot.com/en/docs/workload-api/update-workloads/index.html.md): Linked from this page.
- [Operate deployed Workloads](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/operate-ui.html.md): Linked from this page.
- [View deployed Workloads](https://docs.datarobot.com/en/docs/workload-api/create-workloads/workload-ui.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.
- [Replace and roll out](https://docs.datarobot.com/en/docs/workload-api/update-workloads/replace-artifact-rollouts.html.md): Linked from this page.

## Documentation content

The Console exposes two change-event operations for an existing Workload: Promote (in-place draft-to-locked transition) and Replace artifact (swap the artifact behind the Workload, with a rollout strategy).

For routine controls (start, stop, delete, settings, sharing, importance), see [Operate deployed Workloads](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/operate-ui.html.md). For the Workload list and its monitoring indicators, see [View deployed Workloads](https://docs.datarobot.com/en/docs/workload-api/create-workloads/workload-ui.html.md).

## Promote a draft Workload

To promote a Workload, on the Console > Service tab, locate a Draft Workload (shown in the Artifact column), click the actions menu on that row, and then click Promote and confirm the promotion. The promote action is not available for Locked Workloads.

Or, from the deployed Workload's Overview tab, click the Actions menu in the top-right corner, and then click Promote. To confirm the promotion, in the Promote Workload dialog box, click Promote.

Promote transitions the Workload from `draft` to `locked` in-place: the Workload keeps its identity, endpoint, sharing, and configuration; only the lifecycle policy changes (the 8-hour draft TTL is removed, and statistics are wiped). For the underlying behavior and post-promote iteration paths, see [Promote to production](https://docs.datarobot.com/en/docs/workload-api/update-workloads/promote-production.html.md).

## Replace the artifact behind a Workload

The Replace artifact action is available from the Actions menu on a deployed Workload's detail view only. The two-step Replace artifact panel selects a new artifact and configures the rollout.

> [!NOTE] Artifact replacement rules
> The artifact statuses must match: a locked Workload can only be replaced with another locked artifact, and a draft Workload can only be replaced with another draft artifact. For the full rule set, the rolling rollout strategy, and the timing controls, see [Replace and roll out](https://docs.datarobot.com/en/docs/workload-api/update-workloads/replace-artifact-rollouts.html.md).

To replace the artifact behind a Workload:

1. Open a deployed Workload. In theActionsmenu in the top-right corner, clickReplace artifact.
2. In theReplace artifactpanel, theSelect artifactstep displays a table listing service artifact repositories. ClickFiltersorSearchin the table toolbar to narrow the list. TheArtifactscolumn shows the count of artifacts in the repository.
3. In the table, click a repository name in theRepositorycolumn to expand the repository. Expanding a repository shows the artifacts inside, grouped by status under aLockedtab and aDrafttab (both tabs are always visible, with their counts in parentheses).
4. Click an artifact to select it, and then clickNextin the top-right corner to continue toConfigure.
5. In theConfigurestep, configureSelect Rollout Strategy, set theWarmup duration (minutes), and then optionally configureAutoscalingsettings. For the autoscaling fields, seeConfigure autoscaling.
6. ClickReplacein the top-right corner to submit the replacement request. The platform starts a replacement, and you can monitor the progress next to theActionsmenu.