Errors

DSAR-BE-1208: MANIFEST_ARTIFACT_REPLACE_FAILED

Alpha

DSAR is currently in alpha. APIs, package surfaces, configuration, and documentation may change as the project evolves.

Meaning

Replacement of an existing fulfilment manifest artifact failed. The artifact could not be overwritten in storage.

Probable Causes

The artifact ID does not exist in the manifest's artifacts array.
No fulfilment manifest record exists for the target request.
The uploaded file body is empty (zero bytes).
The storage adapter is not configured (running with "stub" storage).
The storage adapter encountered a write error during overwrite.

How to Fix

Verify the artifact ID exists in the manifest — use GET /requests/:id/manifest to inspect the artifacts list.
Ensure a fulfilment manifest has been created for the request before attempting replacement.
Verify the replacement file is non-empty.
Check storage connectivity and permissions if the adapter is correctly configured.

Retryable

Yes — if the storage adapter was temporarily unavailable, retrying the replacement may succeed.

Minimal Trigger Example

PUT /api/v1/requests/req-123/manifest/artifact/art-456/replace HTTP/1.1
Host: localhost:4086
authorization: Bearer test-token
x-artifact-filename: data-export-redacted.csv
x-artifact-content-type: text/csv
Content-Type: text/csv

<binary file body>