Update Card Carousel

Reference documentation for using the Teams Update Card Carousel action

Written By Support Channel

Last updated 8 months ago

Overview of the Update Card Carousel action

The Update Card Carousel action allows you to modify/change the content or card in an existing carousel sent to Microsoft Teams. This is particularly useful for reflecting changes in status, responding to user input, or dynamically modifying the card content based on workflow progress, without requiring a whole new carousel to be sent into the chat stream.

Purpose

Update an Adaptive Card in an existing carousel that has been sent to Teams

Parameters

1 Teams Instance
1 User Email
1 Card Template
1 Card Carousel to update
1 Card Index
Card Data Values

Output

None

Understanding the Update Card Carousel action

The Update Card Carousel action modifies a card in a carousel that has already been shown to a user. To perform this update, the action needs the following:

Teams Instance - Select the Microsoft Teams instance where the card will be sent

User Email - Enter the email address of the user who should receive the carousel update. This must be a valid user within the selected Teams instance.

Card Template - Choose the Adaptive Card template to be used. See Card Editor for information on card templates.

Card Carousel To Update - An existing Teams Show Card Carousel Action to update

Card Index - The position of the card you want to update within the carousel, starting from 0. This means the first card is index 0, the second is 1.

Card Data - Provide the data needed to populate dynamic elements of the card. These values map to the placeholders or data fields defined in your chosen card template. For example:

  • Title: "Approval #1234"

  • Username: "John Smith"

  • Status: "Pending”

Working with the Update Card Carousel action

The action doesn’t restrict you to using same card or values as before: when updating a card, you can choose a different template with a new layout or content. The values you provide only need to match the new template, not the original one.

A Update Card Carousel is primarily used to modify the content or layout of a card that has already been sent to a card carousel. Instead of posting a new message, the original card is updated in place. There is no return value from the Update Card Carousel action as its effect happens immediately.

Create and manage Update Card Carousel actions

Add an Update Card Carousel action

Add the action

Use the following steps to add the action to a workflow.

Configure the action

Use the following steps to configure the action.

  1. Set values for the fields

    1. Teams Instance

    2. User Email

    3. Card Template

    4. Card Carousel To Update

    5. Card Index

  2. Fill in any Card Data if the template requires this.

  3. Click back in the main view to hide the slide-over.

Delete an Update Card Carousel action

Use the following steps to remove the action from your workflow:

Take care when deleting an action to also remove any logic using its outputs: workflow steps may function incorrectly or break if they attempt to evaluate an output of a deleted action.