Finalize Asset
Instructions
Finalize Asset
Complete a prepared upload, making the asset READY for attachment.
POST
Finalize Asset
Confirms that the prepared storage object exists and that its trusted upload metadata matches the declared asset ID, SHA-256, and size, then moves the asset to
READY. Finalization does not download and independently hash the stored bytes; treat sha256 as client-declared upload metadata. Only READY assets can be attached to pages (an ATTACH_ASSET operation on a non-ready asset conflicts with ASSET_NOT_READY).
Requirements: instructions:write + workspace EDITOR or OWNER + a verified (claimed) account.
Request
string
required
The prepared asset.
Response
object
The asset record —
state: "READY" with a live downloadUrl.