Skip to main content

Stage the metadata document

PUT 
/deposit/:id/metadata

Optional core — provided when deposit.supported is true. See the Deposits guide.

Stage the RO-Crate metadata document for this deposit. This is a full replace — staging a new metadata document discards the previously staged one; there is no metadata PATCH and no metadata DELETE. The metadata document and files may be staged in any order; metadata–file association is checked at finalise.

At finalise the staged metadata document becomes the RO-Crate's authoritative file manifest: each file entity in the metadata document resolves to bytes staged in this deposit, else (for update deposits) to the file carried forward by @id from the baseline version, else remains an unresolved reference. Unresolved references are not protocol errors — they simply 404 when followed — but implementations MAY reject them at finalise via validation. Files present in the baseline but absent from the new metadata document drop out of the new version.

Request​

Responses​

Metadata document staged