Sign in
Media Library

Crop an asset

Server cuts a normalized rectangle from the root original into a new derived asset.

post/api/v1/media/{asset_id}/crop

Path parameters

asset_idstring uuid required

Request body

contextstring required

Target context id, e.g. 'pwa.screenshot'.

widthinteger nullable

Resample the cut region to exactly this width. Omit (with height) to keep the rect's own pixel size. Both must be given together.

heightinteger nullable

See 'width'.

Response

Successful Response

idstring uuid required
kind'image' | 'video' required
filenamestring required
urlstring required

Public URL of the original.

contentTypestring nullable

Sniffed content type, not client-declared.

sizeBytesinteger required
widthinteger nullable
heightinteger nullable
durationMsinteger nullable

Video duration; null in v1 (no ffmpeg).

lqipstring nullable

~20px blurred data-URI for next/image placeholder='blur'.

folderIdstring uuid nullable

null = library root.

originContextstring required

Full upload context, e.g. 'pwa.logo' or 'uncategorized'.

sectionstring required

Derived from originContext prefix; the picker's default facet.

tagsstring[]
isArchivedboolean
sourceAssetIdstring uuid nullable

Root/source asset for a crop or slice; null for uploads.

sourceOpobject nullable

Transform provenance, e.g. {'type':'crop','rect':{...}}.

createdAtstring date-time required
updatedAtstring date-time nullable

Changes

No recorded changes to this endpoint across all 2 revisions of this API.