How to change or close the AdaptiveCard error message by Teams

Wang, Qinjie 240 Reputation points
2026-07-06T02:48:55.6966667+00:00

User's image

Dear Development team,

The current guidance only explains how to handle or hide the success response. Could you please clarify how we can handle or hide the error message shown by Teams, such as “Something went wrong. Please try again”?

docs link:https://learn.microsoft.com/en-us/microsoftteams/platform/task-modules-and-cards/cards/cards-actions?tabs=json&source=docs
thanks

This question is related to the following Learning Module

Microsoft Teams | Development
Microsoft Teams | Development

Building, integrating, or customizing apps and workflows within Microsoft Teams using developer tools and APIs

0 comments No comments

Answer accepted by question author
Anonymous
2026-07-06T03:44:01.6666667+00:00

Hi @Wang, Qinjie

Please note that we're not Microsoft Support or development team, this is a user-to-user community forum. Moderators here don't have access to your environment or Microsoft's backend systems, so we can only provide guidance based on public documentation and community experience.

The current Teams documentation only provides a supported mechanism to hide the success feedback message and does not document any option to suppress or customize the "Something went wrong. Try again" error banner. One possible reason is that the error message serves as client-side feedback when Teams does not receive a successful completion response for the card action. Without such feedback, users might assume their action completed successfully when Teams actually encountered a timeout or response-processing issue.

In similar discussions, the error has been observed in scenarios where Teams does not receive a successful response within the expected timeframe, even though backend processing may continue and eventually complete. As a result, the focus is typically on ensuring the action returns a successful response promptly, rather than on suppressing the Teams-generated error message.

Therefore, the supported mitigation is generally to ensure the action completes successfully within the expected response window, or to return an immediate success response and continue longer-running processing asynchronously.

You can refer to Error message in updated adaptive card message - Microsoft Q&A.

I hope this helps clarify the behavior.


If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".    

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread. 

Was this answer helpful?

1 person found this answer helpful.
0 comments No comments

1 additional answer

Sort by: Newest
  1. Ashlesha Pawar (Tata Consultancy Services Limited) 400 Reputation points Microsoft External Staff
    2026-07-06T05:15:52.05+00:00

    Hi @Wang, Qinjie , thanks for raising this.

    At this time, Teams does not provide a supported option to customize or suppress the client error banner (Something went wrong. Please try again) for Adaptive Card action failures. The documented control is for success feedback handling, not error-banner override.

    So this is expected client behavior. The practical mitigation is to reduce error conditions:

    1. Return a valid success response quickly within the expected action window.
    2. Move long-running work to async/background processing.
    3. Add your own in-card status updates (for example, “Request received, processing...”) after immediate acknowledgment.
    4. Validate payload/schema and action response format strictly to avoid client-side parse/timeout failures.

    If your scenario needs custom error-banner behavior, please treat it as a feature request and raise it via Teams feedback channels. If you want help troubleshooting a specific repro, share action type, response payload, response latency, and whether the backend still completes after the banner appears.

    Was this answer helpful?


Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.