Update apps used in flows

Use Update in the flow designer to refresh a Custom App step from the app's saved configuration. Review the step's parameters and incoming response mappings, then save the flow.

For instructions on configuring the app itself, see Custom apps.

Before you start

Open a flow in DRAFT status. The Update control is available for Custom App steps in drafts; it is hidden when you view a flow in another status.

If the flow is published, select New version from its row's actions menu in Flows and confirm the creation of a draft. Open that draft to update its Custom App steps. See Flow actions for more information about versions and publishing.

Your account's access controls whether Update appears. Your role and tag restrictions also affect whether you can edit and save the flow. See Roles and restrictions.

Identify a pending app change

In the flow designer, a step marked for an update displays a yellow upward-arrow indicator. Its tooltip includes [needs update].

Double-click the step to open its configuration. The Update control's tooltip shows This app has a new update when a change is pending, or This app is up to date otherwise. You can also use Update to refresh a Custom App step that is already marked as up to date.

Update a Custom App step

1. Open your project and select Flows.
2. Open the draft flow you want to edit.
3. Double-click the Custom App step on the canvas.
4. Select Update.
5. In Update this Custom App, select Confirm to refresh the step from the app's latest saved configuration. Select Cancel to leave the step as it is.
6. When the configuration window reopens, review Parameters and Incoming response.
7. If you change values or mappings, select Apply to apply those edits to the step.
8. Close the step's configuration window. Select Save in the flow designer, then Save in the flow dialog to keep the updated draft.

note

Updating a step changes the configuration in the open designer. Save the flow before leaving to keep the update.

Review values and response mappings

The update carries forward values entered in the flow for parameters whose names still match the updated configuration. Review those values and fill in any required parameters before testing.

In Incoming response, response fields with matching response paths retain their existing destination mappings. Check that each response field still maps to the destination you need, especially when the app's response configuration has changed.

Review other Custom App steps in the flow and update them individually as needed.