Content
Media
Upload reusable image assets with useful alt text and safe deletion behavior.
vibecms stores uploaded images as site-scoped assets and returns both an asset ID and a public media URL.
Upload
The supported formats are JPEG, PNG, WebP, and GIF. The decoded file must be 10 MB or smaller.
Always provide concise alt text that describes the useful visual content. A featured or inline image without useful alt text can block publication.
Use an asset
- Set
coverAssetIdto use the image as a featured image. The cover is also the post’s share image (Open Graph / X card); a post without one gets a generated 1200 × 630 card in the blog’s theme. - Insert the returned
/media-assets/<assetId>URL in Markdown for an inline image. - Reuse an existing suitable asset instead of uploading duplicates.
Delete
assets.delete is destructive and requires the separate assets:delete scope. The Write drafts, Write and publish, and Manage key levels do not grant this scope. It returns CONFLICT while the asset is used as a post cover or site social image. Confirm deletion immediately before the call.