Replay executions

Replaying published integration execution lets you rerun an integration using the same parameters as the previous execution, using different parameters, or from a specific point of failure. For example, you can replay an execution if an integration failed due to a timeout error or if the output of an integration is not as expected. For more information about the benefits of replaying executions, seeIntroduction to replay executions.

The following sections describe how to replay executions from the Application IntegrationExecution Logs page.

Required roles

To get the permissions that you need to replay executions, ask your administrator to grant you theApplication Integration Invoker (roles/integrations.integrationInvoker) IAM role on your project. For more information about granting roles, seeManage access to projects, folders, and organizations.

You might also be able to get the required permissions throughcustom roles or otherpredefined roles.

Replay executions

To replay an execution, select one of the following options:

Console

  1. InApplication Integration, go to theLogs page.

    Go to Application Integration Logs

    TheExecution Logs page appears displaying the lists of region specific execution logs.

  2. Click (More actions) for the execution log that you want to replay, and then select Replay.

    If your execution is in theSuspended,On hold, or theRetry on hold state, select the Cancel and replay option.

    Note: You can't cancel an integration execution if the integration is in theIn process state.
  3. In theReplay Execution pane, provide the following inputs:
    1. Reason for replaying the execution: Enter the reason for replaying the execution. This reason is displayed in the execution log and might be useful for debugging.
    2. Replay from point of failure: Select to replay the execution from the point of failure. This resumes from the first failed task or trigger in the previous run.Note: TheReplay from point of failure option only appears for failed executions.
    3. Configure input variables: This section lets you configure the input variables for the replay execution. You can either use the existing values from the previous run or provide new values to replay.
  4. ClickReplay.

    5. The following image shows a sample execution log with theReplay Execution pane open:

    Replay executionsReplay executions

API

Call theprojects.locations.integrations.executions.replay method and provide the ID of the execution that you want to replay:

curl -X POST https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/integrations/INTEGRATION_NAME/executions/EXECUTION_ID:replay -H "Authorization: Bearer $TOKEN"

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.