Skip to main content

Changelog

Updates, changes, and improvements at Retool.

Refer to the stable and edge release notes for detailed information about self-hosted releases.

36 posts tagged with "Workflows"

View All Tags

Analytics for Retool Workflows

The new Analytics page gives you visibility into workflow health and activity across your organization.

From the workflows landing page, select Analytics to access two views:

  • All workflows: Aggregate run counts, failure rates, and resource consumption across every workflow in your organization. Includes a ranked list of your most-run workflows, a Top problem workflows table that surfaces workflows with high failure rates, and resource consumption data for the current month.
  • Individual workflow: Drill into a single workflow to review summary stats, run and latency breakdown charts, resource consumption, and a paginated list of recent runs with per-run status and duration.

Configurable memory limits for workflow code execution on self-hosted instances

Admins can now configure memory limits for workflow code execution at the org level, and workflow editors can override those limits on a per-workflow basis.

  • Org-level defaults: In Settings, go to the Advanced section and click Advanced settings to set a default memory limit (MB) that applies to all workflow runs in your organization.
  • Workflow-level overrides: Open any workflow and go to Settings to override the org default for that workflow.

When a workflow runs a code block, the executor enforces the most specific limit available (workflow > org > server default). If a block exceeds its limit, it fails immediately with a clear error.

Customers who are not configuring limits see no behavior change — the server default of 2,500 MB memory applies. For customers whose workflows were hitting out-of-memory errors, limits can now be tuned without requiring infrastructure changes.

Python runtime version selector and 3.14 availability

You can now select the Python version used by a workflow from the Languages & Libraries tab. Click ... next to Python, select Update version, and choose between Python 3.10 and 3.14.

Python 3.14 does not include built-in libraries. When you upgrade, Retool automatically identifies any built-in libraries your workflow uses and installs them as custom libraries.

Python 3.10 end of life

Python 3.10 will reach end of life on October 31, 2026. After this date, Retool will no longer support Python 3.10 in Workflows.

What's changing

New and existing workflows on Python 3.10 will continue to run but they will not be supported. They will not be automatically migrated to a newer version.

How to upgrade existing workflows

Python 3.14 is rolling out to cloud instances and will be available in an upcoming self-hosted release.

  1. Open the workflow and go to the Languages & Libraries tab.
  2. Click ... next to Python and select Update version.
  3. Choose Python 3.14 and click Apply.

When you upgrade, Retool automatically identifies built-in libraries your workflow uses and installs them as custom libraries. Python 3.14 is mostly backwards-compatible, but Retool recommends publishing a workflow release before upgrading so you can revert if needed.

See Configure Python version for full details on how to upgrade and revert to a previously published release.

Timeline

DateEvent
April 2026Python 3.14 available
October 31, 2026Python 3.10 End-of-Life (EOL); support removed from Retool Workflows

Delete workflows with the Retool API

You can now delete workflows programmatically using the DELETE /api/v2/workflows/{workflowId} endpoint in the Retool REST API.

To use this endpoint, your API token must have the workflows:write scope. The endpoint only supports deleting standard workflows—deleting agents and functions via the API is not supported.

Refer to the Retool API reference for full endpoint details, including request parameters and error responses.

Design update to workflows landing page

Retool made significant design updates to the workflows landing page to improve user experience and align more closely with the agents landing page.

The workflows landing page was updated for cloud instances. It will be available in an upcoming edge release, and is expected in the Q2 stable release for self-hosted instances. To revert to the previous landing page experience, toggle off the Reskin workflow index page to render agents home page UI feature flag in Settings > Beta.

The landing page displays all workflows, and folders containing workflows, for your Retool organization. You can perform the following actions from the landing page:

  • Sort workflows by Name, Last Updated date, or Created date.
  • Search for workflows.
  • Toggle between Grid view or Table view.
  • Refresh the workflows list.
  • Import a workflow from JSON.
  • Create a new Folder.
  • Create a new Workflow.
  • Create a workflow From Template.

Unpublish a workflow release

You can now unpublish workflow releases from the Releases tab.

This feature is also available for workflows protected with Source Control. When unpublishing a release on a protected workflow, the latest saved version on the main branch will be live to users.

Unpublish a workflow release

You can now unpublish workflow releases from the Releases tab.

Reach out to your account manager to enable unpublish for workflows.

This feature is also available for workflows protected with Source Control. When unpublishing a release on a protected workflow, the latest saved version on the main branch will be live to users.

Create README files for workflows

You can now create a README from the workflow IDE to help clarify important information about your workflow for collaborators. For example, if a workflow requires certain permissions on a resource, or if it's only scheduled to run once a week.

This feature is also available for workflows protected with Source Control. To create a README, click the title of the workflow and add content to the Editor README field. READMEs are visible from the Edit workflow details dialog box, in workflows JSON exports, and in a markdown file from source control.

Protected workflow triggers

Enterprise customers can now use Source Control to protect workflow triggers. This prevents changes to a workflow's triggers without review. When you protect a workflow for the first time, triggers are now automatically included.

To enable protected workflow triggers for self-hosted Retool on the stable channel, reach out to your Account Manager to enable the Allow users to edit triggers on branches feature flag.

For workflows that are already protected, you now have the option to protect triggers using a new PR.

Once protected, triggers are versioned and published alongside each release. Information about your triggers is stored in the startTrigger.yml file in your Source Control repository.