Overview of the Update Card action

The Update Card action allows you to update an existing Adaptive Card that was previously sent to a user in 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.

Understand the Update Card action

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

Teams Instance

Select the Microsoft Teams instance the card should be sent to

User Email

Enter the email address of the user who should receive the card. 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 To Update

The existing Teams Show Card Action to update.

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”

Add the action

Configure the action

1. Select Teams Instance, User Email, Card Template and Card To Update

2. Fill in the Card Data if the template has any

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

Delete an Update Card action

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

1. Access the workflow in draft mode to edit it.

2. Either:

   • hover your mouse cursor over the action, and then click the red cross that appears over the top-right corner of the action to delete it. Or:

   • click on the action to open the action slide-over. Click the red 'Delete Step’ button to remove the action from your workflow.

3. Click Publish in the top-right to commit your changes.

When the Teams Update Card action is deleted, there are no dependant expressions or variables that will be affected.

Use an Update Card action

When updating a card, you may choose a different card template with a new layout or content. The values you provide only need to match the new template, not the original one.

An Update Card action is primarily used to change the content or layout of an already-sent card. Rather than sending a new message, the original card is directly updated. This helps to keep conversations clear and eliminates clutter from repeated messages.