# API quick reference

> API quick reference - A quick reference to the Workload API endpoint groups and authentication
> baseline.

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-07-30T11:40:01.817509+00:00` (UTC).

## Primary page

- [API quick reference](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/api-quick-reference.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [認証](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/api-quick-reference.html.md#authentication): In-page section heading.
- [Endpoint groups](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/api-quick-reference.html.md#endpoint-groups): In-page section heading.
- [Resource APIs](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/api-quick-reference.html.md#resource-apis): In-page section heading.
- [Telemetry and access](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/api-quick-reference.html.md#telemetry-and-access): In-page section heading.

## Documentation content

The following provides a quick map of the Workload API REST surface, organized by endpoint group.

> [!NOTE] MLOps deployment API
> Model and custom-model deployments (for example `/api/v2/deployments/`) are not part of the Workload API. Use Workloads and artifacts for governed container runtimes; use the [Deployments API reference](https://docs.datarobot.com/ja/docs/api/reference/public-api/tag-deployment-management.html.md) for classic prediction deployments.

## 認証

All API requests require Bearer token authentication:

```
Authorization: Bearer YOUR_API_TOKEN 
```

## Endpoint groups

The Workload API is organized into endpoint groups, each with a specific purpose, with telemetry and access control spanning all of them.

### Resource APIs

The following describes the top-level base API paths and what those paths cover.

| グループ | Base path | 機能 | REST index |
| --- | --- | --- | --- |
| ワークロード | /workloads | CRUD; start/stop; promotion; runtime settings (rollouts follow Replace and roll out); statistics with reset-by-window; events; replacement history; related entities; nested protons (including per-replica statusDetails). | Create and read, Operate, Update |
| アーティファクト | /artifacts | CRUD; draft vs. locked status; image builds (POST/GET /artifacts/{id}/builds); build inspection; POST /artifacts/{id}/clone. | REST: artifacts and repositories |
| Artifact repositories | /artifactRepositories | Repository metadata; artifact version history; discovery (see Artifact concepts). | REST: artifacts and repositories |

### Telemetry and access

The Workload-scoped observability and role APIs span the preceding resource groups.

| 特徴量 | 位置 | リファレンス |
| --- | --- | --- |
| Telemetry | Workload-scoped OpenTelemetry (logs, metrics, traces) | Monitoring concepts |
| Shared roles | sharedRoles under Workloads, artifacts, and artifact repositories | Sharing and access control (SharingRole, update payload) |