Contentstack Management - Assets Actions

Within Contentstack, all uploaded files such as images, videos, PDFs, audio files, and more are stored in your repository for later access. This repository, where uploaded files reside, is referred to as Assets. You can perform asset based operations using the following Contentstack Management Assets actions.

Let’s look at each of them in detail.

Create an Asset

This action lets you create a new asset in Contentstack.

1. Under Choose an Action tab, select the Create an Asset action.
2. On the Create an Asset Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
   2. Select a Stack from the Lookup list and enter a Title for the asset.
   3. Specify a File Name for the asset, such as ‘NewAsset.png’ or ‘NewAsset.jpeg.’
      
   4. Enter the Input URL of the image you want to create and specify a suitable Description for the asset.
      
   5. Optionally, enable the Show Optional Fields toggle button to display the Select Folder field.
   6. In the Select Folder drop-down, choose a destination folder to store your asset.
      
3. Once done, click Proceed.
4. Click Test Action to test the configured action.
   
5. On successful configuration, you can see the below output. Click Save and Exit.
   

Delete an Asset

This action lets you delete an asset in Contentstack.

1. Under Choose an Action tab, select the Delete an Asset action.
2. On the Delete an Asset Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
   2. Select a Stack and Branch from the Lookup list.
   3. In the Select Asset drop-down, select the asset you want to delete.
      
3. Once done, click Proceed.
4. Click Test Action to test the configured action.
   
5. The output will be shown as follows. Click the Save and Exit button.
   

Get All Assets

This action lets you fetch details of all the assets in your stack.

1. Under Choose an Action tab, select the Get All Assets action.
2. On the Get All Assets Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
   2. Select a Stack, Environment, and Branch from the Lookup list.
      

      Note: By default, the main branch is selected (even if the Branch field is empty).

   3. Optionally, enable the Show Optional Fields toggle button to display the Asset Limit, Skip Asset (Pagination) fields.
   4. In the Select Folder drop-down, select a folder to fetch the details of all the assets present in the folder.

      Additionally, you can mark the Include count, Include publish details and Include metadata checkboxes to display the count of the total number of assets, publish and metadata details in the output.

      
3. Once done, click Proceed.
4. Click Test Action to test the configured action.
   
5. The output will be shown as follows. Click the Save and Exit button.
   

Get a Single Asset

1. Under Choose an Action tab, select the Get a Single Asset action.
2. On the Get a Single Asset Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
   2. Select a Stack, Environment, Asset, and Branch from the Lookup list.
      

      Note: By default, the main branch is selected (even if the Branch field is empty).

   3. Optionally, enable the Show Optional Fields toggle button to display additional fields. Enter the asset Version to fetch the details of the asset. 
      
3. Once done, click Proceed.
4. Click Test Action to test the configured action.
   
5. The output will be shown as follows. Click the Save and Exit button.
   

Publish an Asset

This action lets you publish an asset automatically in your stack. To know more, visit publish assets.

1. Under Choose an Action tab, select the Publish an Asset action.
2. On the Publish an Asset Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
   2. Select a Stack, Branch, and an Asset from the Lookup list.
      You can fetch the UID for all the previously configured automation steps directly from the Lookup list as shown below:

      Note: To dynamically fetch assets, configure the Asset Trigger and fetch the asset UID.

      

      Note: By default, the main branch is selected (even if the Branch field is empty).

   3. Select the Environment(s) from the Lookup list where you want to publish the asset.
      
   4. [Optional] Enable the Show Optional Fields toggle button to display the Select Locale(s) and Publish Schedule fields.
      

      Note: You can select multiple Environment(s) and Locale(s) to publish the asset.

3. Once done, click Proceed. 
4. Click Test Action to test the configured action.
   
5. On successful configuration, you can see the below output. Click Save and Exit. A publish and unpublish icon will appear for the asset on the entry page.
   

Update an Asset

This action lets you update an existing asset in Contentstack.

1. Under Choose an Action tab, select the Update an Asset action.
2. On the Update an Asset Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
   2. Select a Stack and an Asset from the Lookup list.
   3. Enter a Title and a suitable Description for the asset to update.
   4. Specify a File Name for the asset, such as ‘Travel_Friendly.png’ or ‘Travel_Friendly.jpeg.’ Enter the Input URL of the image you want to update.
      
   5. Optionally, enable the Show Optional Fields toggle button to display the Select Folder field.
   6. In the Select Folder drop-down, choose a destination folder to update an asset in it.
      
3. Once done, click Proceed.
4. Click Test Action to test the configured action.
   
5. On successful configuration, you can see the below output. Click Save and Exit.