Managing assets
Log in to add to favouritesCreate an asset
Before an asset can be created, an asset file needs to be uploaded. This will return a temporary fileId value which can be used as a file reference when creating the entry that represents the asset.
The AssetFile type needs to used in a field called "sysAssetFile" and the dataFormat within the sys object needs to be specified as "asset".
Example request
The JSON below is example of an entry that represents an asset. This can be used to create an asset in the same way as creating an entry as assets are entries with additional properties.
{
"title": "Batman Returns",
"sysAssetFile": {
"fileId": "25bd73bb-cbb0-454f-a762-2bee08a68cbe.jpg",
"parentNodePath": "/uploads/movie-posters"
},
"sys": {
"projectId": "movieDb",
"dataFormat": "asset"
}
}Updating an asset
Asset fields (i.e. title, description) can be updated just like an entry, but updating the file that an asset represents requires a new file to be uploaded as an asset file beforehand and then a new file reference be set.
Example request
In the example below a new "fileId" has been specified in the "sysAssetFile" field. When the entry is updated then the file that the entry represents is updated.
{
"title": "Batman Returns",
"Description": "Batman Returns release poster",
"sysAssetFile": {
"fileId": "97d70ad2-017f-46ff-8d9e-f8d054652d9c.jpg"
},
"sys": {
"id": "0484bd0b-86d3-4d26-ac97-67514add802b",
"contentTypeId": "image",
"projectId": "movieDb",
"dataFormat": "asset",
"language": "en-GB",
"version": {
"versionNo": "1.0"
}
}
}