# REST: Create and read Workloads

> REST: Create and read Workloads - Primary Workload HTTP operations with links to the API reference.

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

## Primary page

- [REST: Create and read Workloads](https://docs.datarobot.com/en/docs/workload-api/create-workloads/workloads-rest-endpoints.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.
- [Create Workloads](https://docs.datarobot.com/en/docs/workload-api/create-workloads/index.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.
- [REST: update Workloads](https://docs.datarobot.com/en/docs/workload-api/update-workloads/update-rest-endpoints.html.md): Linked from this page.

## Documentation content

The following endpoints create and read Workloads.

| Verb | Path | Description |
| --- | --- | --- |
| POST | /workloads | Create a Workload from an existing artifact (artifactId) or an inline artifact spec. Returns WorkloadFormatted. |
| GET | /workloads | List Workloads. Filter by status, artifactStatus, importance, artifactId, repositoryId, type, tagKeys, tagValues, createdBy, search, ids. Sort with orderBy (name, createdAt, updatedAt, status, importance, prefix - for descending). Set serviceStats=true to include recent service statistics inline. |
| GET | /workloads/{workload_id} | Get a single Workload. |

See [REST: operate Workloads](https://docs.datarobot.com/en/docs/workload-api/operate-workloads/operate-rest-endpoints.html.md) for day-2 operations (start, stop, delete, settings, sharing, stats, events, protons) and [REST: update Workloads](https://docs.datarobot.com/en/docs/workload-api/update-workloads/update-rest-endpoints.html.md) for change events (promote, replacement history).