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

FieldTypeNotes
descriptionstring | nullSet 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

CodeWhen
200Updated โ€” returns the attachment resource with the new description
400Empty body, unknown field, or description over 2000 chars
404Record or attachment not visible to the caller's org
409Attachment is locked (submitted version) or archived

Required scope: eudr:write