v1

latestOpenAPI 3.1.0Apache-2.02026-07-17586455.2 KB
Storage

Soft-delete an artifact (optionally cascading documents).

Reference-aware delete. Default policy=artifact_only returns 409 artifact_in_use if any active document references the artifact; policy=with_documents cascades a soft-delete to those documents first. No force parameter is supported.

delete/v1/storage/artifacts/{id}

Path parameters

idstring uuid required

Query parameters

policy'artifact_only' | 'with_documents'

Delete behaviour when documents reference the artifact. artifact_only (default) returns 409 artifact_in_use if any non-deleted documents reference it. with_documents cascades a soft-delete to those documents first.

Delete behaviour when documents reference the artifact. artifact_only (default) returns 409 artifact_in_use if any non-deleted documents reference it. with_documents cascades a soft-delete to those documents first.

Response

Artifact deleted (or delete failed at the backend).

artifact_idstring uuid required
cascaded_document_idsstring[]
status'deleted' | 'delete_failed' required