# Operate running Workloads

> Operate running Workloads - Lifecycle, settings, sharing, REST, and console operations for running
> Workloads.

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

## Primary page

- [Operate running Workloads](https://docs.datarobot.com/en/docs/workload-api/operate-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.
- [Update existing Workloads](https://docs.datarobot.com/en/docs/workload-api/update-workloads/index.html.md): Linked from this page.
- [Lifecycle states](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/lifecycle-states.html.md): Linked from this page.
- [Lifecycle actions](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/lifecycle-actions.html.md): Linked from this page.
- [Runtime settings](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/runtime-settings.html.md): Linked from this page.
- [Sharing and access control](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/sharing-access-control.html.md): Linked from this page.
- [REST: Operate Workloads](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/operate-rest-endpoints.html.md): Linked from this page.
- [UI: Operate deployed Workloads](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/operate-ui.html.md): Linked from this page.
- [UI: Access Workload endpoints](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/endpoints-ui.html): Linked from this page.
- [UI: Configure Workload capacity](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/capacity-ui.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

This section covers the day-to-day operations of a Workload, once it is running: starting and stopping, tuning runtime settings (replicas, autoscaling, resources), managing who can see and use it, and inspecting its lifecycle. For change events that swap the artifact or promote a draft, see [Update existing Workloads](https://docs.datarobot.com/en/docs/workload-api/update-workloads/index.html.md).

| Resource | Description |
| --- | --- |
| Lifecycle states | States, transitions, pod-based truth, debugging, and how protons aggregate status. |
| Lifecycle actions | Lifecycle actions for Workloads—start, stop, delete, and the draft 8-hour TTL (time-to-live). |
| Runtime settings | Importance, names, runtime, autoscaling (scaling metrics), and resource configuration. |
| Sharing and access control | sharedRoles model and propagation to sub-resources. |
| REST: Operate Workloads | Start, stop, delete, settings, sharing, stats, events, and proton APIs. |
| UI: Operate deployed Workloads | Settings tab autoscaling, metadata edits, sharing, and lifecycle actions (deactivate, delete, clear stats). |
| UI: Access Workload endpoints | Endpoints tab with copy-ready invoke examples (Python, cURL) and OpenTelemetry instrumentation snippets. |
| UI: Configure Workload capacity | Capacity tab for throughput, quota reservations, entity capacity floors, and rate-limit policies. |