Update Attachment
Edit an attachment's mutable operator metadata. Currently the only editable
field is the free-text description (EPO-1728) โ what the evidence is.
โถRequest body
| Field | Type | Notes |
|---|---|---|
description | string | null | Set the description (trimmed, โค 2000 chars); null (or a blank string) clears it |
The body is strict and must carry description โ an empty body ({}) or an
unknown field returns 400. Filename, category, source, content-type, size,
plot links and verification status are not editable here (plot links have
their own Link Plot / Unlink Plot routes).
โถImmutable once submitted
When the attachment's DDS version has been submitted, the attachment is
frozen (part of the filed record) and this returns 409 Conflict.
Editing an archived (soft-deleted) attachment also returns 409.
โถEffect on the PDF / export package
Editing the description changes the audit-trail report content, so the stored
PDF and export package are marked stale and rebuilt automatically on the
next request (the edit is recorded as an attachment.updated audit event).
โถStatus codes
| Code | When |
|---|---|
200 | Updated โ returns the attachment resource with the new description |
400 | Empty body, unknown field, or description over 2000 chars |
404 | Record or attachment not visible to the caller's org |
409 | Attachment is locked (submitted version) or archived |
Required scope:
eudr:write