Contentstack Management - Releases Actions

A Release comprises entries and assets that need to be deployed at the same time, either in a published or unpublished state, to a designated environment. You can perform release based operations using the Contentstack Management Releases actions.

Click to enlarge

Let’s look at each of these in detail.

This action lets you add multiple items to a release.

1. Under Choose an Action tab, select the Add Items to a Release action.
2. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
3. Select a Stack, Branch, and Release from the Lookup list. Provide your item data in the Release Item Data field.

   NoteProvide your entry data as per the schema in JSON format only. Both entries and assets can be added to the release. In case of assets, the value for the content_type_uid key should be built_io_upload.

   Click to enlarge

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

4. [Optional] Enable the Show Optional Fields toggle button to display the branch details by clicking the Include branch checkbox.
   
   Click to enlarge
5. Once done, click Proceed.
6. Click Test Action to test the configured action.
   
   Click to enlarge
7. The output will be shown as follows. Click the Save and Exit button.
   
   Click to enlarge

This action lets you create a copy of a release.

1. Under Choose an Action tab, select the Clone a Release action.
2. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
3. Select a Stack, Branch, and Release from the Lookup list.
   
   Click to enlarge

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

4. Provide a Release Name and a Release Description for the release to be created.
   
   Click to enlarge
5. [Optional] Enable the Show optional fields toggle button to display the branch details by clicking the Include branch checkbox.
   
   Click to enlarge
6. Once done, click Proceed.
7. Click Test Action to test the configured action.
   
   Click to enlarge
8. The output will be shown as follows. Click the Save and Exit button.
   
   Click to enlarge

This action lets you create a release.

1. Under Choose an Action tab, select the Create a Release action.
2. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
3. Select a Stack, Release Name, Release Description, and Branch from the Lookup list.
   
   Click to enlarge

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

4. [Optional] Enable the Show Optional Fields toggle button to display the branch details by clicking the Include branch checkbox.
   
   Click to enlarge
5. Once done, click Proceed.
6. Click Test Action to test the configured action.
   
   Click to enlarge
7. The output will be shown as follows. Click the Save and Exit button.
   
   Click to enlarge

This action lets you delete multiple items from a release.

1. Under Choose an Action tab, select the Delete Items from a Release action.
2. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
3. Select a Stack, Branch, and Release from the Lookup list. Provide your item data in the Release Item Data field.

   Note Provide your entry data as per the schema in JSON format only. 

   Click to enlarge

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

4. [Optional] Enable the Show Optional Fields toggle button to display the branch details by clicking the Include branch checkbox.
   
   Click to enlarge
5. Once done, click Proceed.
6. Click Test Action to test the configured action.
   
   Click to enlarge
7. The output will be shown as follows. Click the Save and Exit button.
   
   Click to enlarge

This action lets you deploy a release to an environment.

1. Under Choose an Action tab, select the Deploy a Release action.
2. On the Deploy a Release 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 Release from the Lookup list.
      
      Click to enlarge

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

   3. Select the Environment(s) to deploy the release from the Lookup list.
      
      Click to enlarge
   4. [Optional] Enable the Show Optional fields toggle button to display the Publish Schedule field to schedule the deployment of the release.
      

      Note The release will be published immediately if the Publish Schedule field is empty.

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

This action fetches all the items present in a release.

1. Under Choose an Action tab, select the Get All Items in a Release action.
2. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
3. Select a Stack, Branch, and Release from the Lookup list.
   
   Click to enlarge

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

4. [Optional] Enable the Show Optional Fields toggle button to display the Locale. You can also include the branch details by clicking the Include branch checkbox.
   
   Click to enlarge
5. Once done, click Proceed.
6. Click Test Action to test the configured action.
   
   Click to enlarge
7. The output will be shown as follows. Click the Save and Exit button.
   
   Click to enlarge

This action fetches all the releases present in a stack.

1. Under Choose an Action tab, select the Get All Releases action.
2. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
3. Select a Stack, and Branch from the Lookup list. Click the checkboxes for Include Count and Include count of release items to fetch the release details.
   
   Click to enlarge

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

4. [Optional] Enable the Show Optional Fields toggle button to display the Limit Release, and Skip Release fields. You can also include the branch details by clicking the Include branch checkbox.
   
   Click to enlarge
5. Once done, click Proceed.
6. Click Test Action to test the configured action.
   
   Click to enlarge
7. The output will be shown as follows. Click the Save and Exit button.
   
   Click to enlarge

This action fetches the details of a single release.

1. Under Choose an Action tab, select the Get a Single Release action.
2. Click + Add New Account button to connect your Contentstack account as shown in the Connect your Contentstack Account to Automate step.
3. Select a Stack, Branch, and Release from the Lookup list.
   
   Click to enlarge

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

4. [Optional] Enable the Show Optional Fields toggle button to display the branch details by clicking the Include branch checkbox.
   
   Click to enlarge
5. Once done, click Proceed.
6. Click Test Action to test the configured action.
   
   Click to enlarge
7. The output will be shown as follows. Click the Save and Exit button.
   
   Click to enlarge