Assets

Store an image or video permanently for a site

Fetch-by-URL rehosting: pass an HTTPS URL (including expiring signed URLs) and Mondovo downloads the file, stores it permanently on its CDN, registers it in the site’s asset library, and returns a stable URL. Allowed types: images (JPG, PNG, WebP, GIF; max 20 MB) and video (MP4, WebM, MOV; max 80 MB — videos are optimized for the web after upload). Requires scope assets:write or sites:refine.

post/api/v1/sites/{id}/assets

Request

  • Base URL: https://app.mondovo.com
  • URL: https://app.mondovo.com/api/v1/sites/{id}/assets
  • Auth: HTTP bearer

Request body

urlstring uri required

HTTPS URL of the image or video to store permanently (a generated image, stock URL, or expiring signed URL). Mondovo downloads it and returns a stable CDN URL.

alt_textstring

Optional label / alt text kept on the asset.

filenamestring

Optional display name for the asset library. The stored file name is always derived from the validated content type.

Response

Stored. Use url — it never expires.

site_idstring uuid required
asset_idstring uuid

Asset-library record ID (may be omitted).

urlstring uri required

Permanent CDN URL.

type'image' | 'video' required
mime_typestring required
bytesinteger required

Stored size in bytes.

messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.