v1

latestOpenAPI 3.0.02026-08-06194226589.8 KB

Assets

Upsert an asset.

You can only upload one file at a time. The mime type of the file is not calculated by Squidex and is required correctly.

post/api/apps/{app}/assets/{id}

Path parameters

appstring required

The name of the app.

idstring required

The optional custom asset id.

Query parameters

parentIdstring

The optional parent folder id.

duplicateboolean

True to duplicate the asset, event if the file has been uploaded.

Response

Asset created or updated.

_linksobject required

The links.

idstring required

The ID of the asset.

parentIdstring required

The ID of the parent folder. Empty for files without parent.

fileNamestring required

The file name.

fileHashstring nullable

The file hash.

isProtectedboolean required

True, when the asset is not public.

slugstring required

The slug.

mimeTypestring required

The mime type.

fileTypestring required

The file type.

metadataTextstring required

The formatted text representation of the metadata.

editTokenstring nullable

The UI token.

metadataobject required

The asset metadata.

tagsstring[] nullable

The asset tags.

fileSizeinteger required

The size of the file in bytes.

fileVersioninteger required

The version of the file.

type'Unknown' | 'Image' | 'Audio' | 'Video' required

createdBystring required

The user that has created the schema.

lastModifiedBystring required

The user that has updated the asset.

createdstring date-time required

The date and time when the asset has been created.

lastModifiedstring date-time required

The date and time when the asset has been modified last.

versioninteger required

The version of the asset.

isImageboolean required

Determines of the created file is an image.

pixelWidthinteger nullable

The width of the image in pixels if the asset is an image.

pixelHeightinteger nullable

The height of the image in pixels if the asset is an image.