# REST: Artifacts and repositories

> REST: Artifacts and repositories - HTTP surface for artifacts 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.246000+00:00` (UTC).

## Primary page

- [REST: Artifacts and repositories](https://docs.datarobot.com/en/docs/workload-api/build-artifacts/artifacts-rest-endpoints.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [Artifacts](https://docs.datarobot.com/en/docs/workload-api/build-artifacts/artifacts-rest-endpoints.html.md#artifacts): In-page section heading.
- [Artifact sharing](https://docs.datarobot.com/en/docs/workload-api/build-artifacts/artifacts-rest-endpoints.html.md#artifact-sharing): In-page section heading.
- [Artifact repositories](https://docs.datarobot.com/en/docs/workload-api/build-artifacts/artifacts-rest-endpoints.html.md#artifact-repositories): In-page section heading.

## Related documentation

- [Workload API](https://docs.datarobot.com/en/docs/workload-api/index.html.md): Linked from this page.
- [Build artifacts](https://docs.datarobot.com/en/docs/workload-api/build-artifacts/index.html.md): Linked from this page.
- [API reference](https://docs.datarobot.com/en/docs/workload-api/get-started-workloads/api-quick-reference.html.md): Linked from this page.

## Documentation content

Use these paths together with [API reference](https://docs.datarobot.com/en/docs/workload-api/get-started-workloads/api-quick-reference.html.md) authentication and models.

## Artifacts

These endpoints create, read, update, clone, and delete artifacts.

| Verb | Path | Description |
| --- | --- | --- |
| GET | /artifacts | List artifacts. Filter by type, status, repositoryId, tagKeys, tagValues, createdBy, search, ids. Sort with orderBy (name, createdAt, updatedAt, status; prefix - for descending). |
| POST | /artifacts | Create a new artifact in draft status. Set artifactRepositoryId in the body to add it to a repository (the platform creates the repository automatically if it does not exist). |
| GET | /artifacts/{artifact_id} | Get a single artifact. |
| PUT | /artifacts/{artifact_id} | Replace all artifact fields. |
| PATCH | /artifacts/{artifact_id} | Partial update. Use to lock the artifact: {"status": "locked"}. |
| DELETE | /artifacts/{artifact_id} | Delete an artifact. Returns 409 if the artifact is locked or in use by a Workload. |
| POST | /artifacts/{artifact_id}/clone | Clone an existing artifact under a new name. |

## Artifact sharing

These endpoints list and replace the roles granted on an individual artifact.

| Verb | Path | Description |
| --- | --- | --- |
| GET | /artifacts/{artifact_id}/sharedRoles | List roles granted on an artifact. |
| PATCH | /artifacts/{artifact_id}/sharedRoles | Replace the artifact role list (up to 100 entries). |

## Artifact repositories

These endpoints manage repositories that group artifact versions and govern shared access.

| Verb | Path | Description |
| --- | --- | --- |
| GET | /artifactRepositories | List repositories. |
| GET | /artifactRepositories/{artifact_repository_id} | Get a repository. |
| DELETE | /artifactRepositories/{artifact_repository_id} | Delete a repository. Cascades to non-locked, unused artifacts; returns 409 otherwise. |
| GET | /artifactRepositories/{artifact_repository_id}/sharedRoles | List repository roles. |
| PATCH | /artifactRepositories/{artifact_repository_id}/sharedRoles | Replace the repository role list. |

The platform creates a repository automatically the first time you create an artifact with `artifactRepositoryId` set.