---
title: "Delete an artifact (soft delete)"
method: DELETE
path: "/v1/artifacts/{id}"
tags: ["Artifacts"]
---

# Delete an artifact (soft delete)

`DELETE /v1/artifacts/{id}`

Soft delete with a 30-day recovery window — not an immediate purge. The artifact is hidden from listings and stops serving, and its routing slug is freed for re-publish, but its files, versions, and data store are kept so it can be restored via `POST /v1/artifacts/{id}/restore` until the window elapses (a daily sweep hard-purges it after that). Caller must be the artifact owner, or a workspace owner/admin when the artifact is workspace-owned (`owner_id` is null).

## Response `200`

Moved to trash

- object
  - `success` boolean
  - `deleted` string — Artifact id
  - `deleted_at` string, date-time
  - `recoverable_until` string, date-time — After this time the artifact is permanently purged.
  - `retention_days` integer
  - `restore_url` string
  - `message` string

## Other responses

- `403` — Access denied
- `404` — Resource not found

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/versions/804359ead65a/schema)