From 21999a88c9f9721e68d3cf5f33e46c358d39efd1 Mon Sep 17 00:00:00 2001 From: betzlermeow Date: Fri, 26 Jun 2026 17:18:04 -0700 Subject: [PATCH 1/4] docs: add dated retirement banner and "don't create" notice to all Workflows pages Workflows is being deprecated (retiring August 18, 2026). Only the migration guide carried the direct, dated retirement notice; the rest of the Workflows pages had softer "no longer recommended" banners or, in the case of the intro page, a banner actively encouraging new builds. This brings every Workflows page in line: - Adds the dated retirement warning (retires Aug 18, 2026) to the overview, quickstart, and all six example pages, above their existing page-specific recommendation/links. - Replaces the green "Start building today" launch banner on the intro page (fern/workflows.mdx) with the retirement warning, and adds a reminder at the "Creating Your First Workflow" walkthrough. - Makes the messaging explicit that users should NOT create new workflows even though the dashboard still allows it (the dashboard has not yet been updated). Co-Authored-By: Claude Opus 4.8 --- fern/workflows.mdx | 12 +++++++++--- fern/workflows/examples/appointment-scheduling.mdx | 2 ++ fern/workflows/examples/clinic-triage-scheduling.mdx | 2 ++ .../examples/ecommerce-order-management.mdx | 2 ++ fern/workflows/examples/lead-qualification.mdx | 2 ++ fern/workflows/examples/multilingual-support.mdx | 2 ++ fern/workflows/examples/property-management.mdx | 2 ++ fern/workflows/overview.mdx | 12 ++---------- fern/workflows/quickstart.mdx | 2 ++ 9 files changed, 25 insertions(+), 13 deletions(-) diff --git a/fern/workflows.mdx b/fern/workflows.mdx index 68b212d38..1e6600306 100644 --- a/fern/workflows.mdx +++ b/fern/workflows.mdx @@ -4,14 +4,20 @@ subtitle: Break down AI conversations into a visual workflow made up of discrete slug: workflows --- - - Workflows is now available to all Vapi users in Open Beta on [the dashboard here](https://dashboard.vapi.ai/workflows). Start building more reliable and structured conversational AI today. - + +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. + +We no longer recommend Workflows for new builds. Prefer **Assistants** or **Squads** depending on complexity. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). This page is retained for legacy reference. + Workflows is a new way to build conversational AI. It allows you to break down AI conversations into discrete steps, and then orchestrate those steps in a way that is easy to manage and modify. ## Creating Your First Workflow + +The steps below are retained for legacy reference only. **Don't create new workflows** — the dashboard still allows it, but new builds should use [Assistants](/assistants/dynamic-variables) or [Squads](/squads) instead. + + Begin by creating an assistant on the Assistants page and providing the required information, such as the assistant's name and capabilities. Once your assistant is set up, switch the model provider to Vapi and click "Create Workflow" when prompted. A modal will appear offering you the option to create a new workflow or attach to an existing one. Choose the appropriate option to proceed to the Workflow Builder. diff --git a/fern/workflows/examples/appointment-scheduling.mdx b/fern/workflows/examples/appointment-scheduling.mdx index f5631c476..9b42931be 100644 --- a/fern/workflows/examples/appointment-scheduling.mdx +++ b/fern/workflows/examples/appointment-scheduling.mdx @@ -6,6 +6,8 @@ description: Build a voice AI appointment scheduling workflow with calendar inte --- +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. + This example uses Workflows. For new builds, use **Assistants** or **Squads**. See the updated guides: [Assistant - Appointment Scheduling](/assistants/examples/appointment-scheduling) or [Squads](/squads). diff --git a/fern/workflows/examples/clinic-triage-scheduling.mdx b/fern/workflows/examples/clinic-triage-scheduling.mdx index 18004c1c8..2d9a66c72 100644 --- a/fern/workflows/examples/clinic-triage-scheduling.mdx +++ b/fern/workflows/examples/clinic-triage-scheduling.mdx @@ -6,6 +6,8 @@ description: Build a voice AI clinic workflow with medical triage protocols, app --- +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. + This example uses Workflows. For new builds, use **Squads** for multi-assistant triage and scheduling. See: [Squad - Clinic Triage & Scheduling](/squads/examples/clinic-triage-scheduling). diff --git a/fern/workflows/examples/ecommerce-order-management.mdx b/fern/workflows/examples/ecommerce-order-management.mdx index 20cc50d4d..ad3e44cee 100644 --- a/fern/workflows/examples/ecommerce-order-management.mdx +++ b/fern/workflows/examples/ecommerce-order-management.mdx @@ -6,6 +6,8 @@ description: Build a voice AI e-commerce workflow with order tracking, return pr --- +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. + This example uses Workflows. For new builds, use **Squads** with specialized assistants for orders, returns, and VIP support. See: [Squad - E‑commerce Order Management](/squads/examples/ecommerce-order-management). diff --git a/fern/workflows/examples/lead-qualification.mdx b/fern/workflows/examples/lead-qualification.mdx index 96cbd96d4..012e80f56 100644 --- a/fern/workflows/examples/lead-qualification.mdx +++ b/fern/workflows/examples/lead-qualification.mdx @@ -6,6 +6,8 @@ description: Build a voice AI outbound sales workflow with lead qualification, C --- +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. + This example uses Workflows. For new builds, use **Assistants** or **Squads**. See: [Assistant - Lead Qualification](/assistants/examples/lead-qualification) and [Squads](/squads). diff --git a/fern/workflows/examples/multilingual-support.mdx b/fern/workflows/examples/multilingual-support.mdx index c30bab4b7..fff3d7c5c 100644 --- a/fern/workflows/examples/multilingual-support.mdx +++ b/fern/workflows/examples/multilingual-support.mdx @@ -6,6 +6,8 @@ description: Build a multilingual voice AI customer support workflow with langua --- +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. + This example uses Workflows. For new builds, use a **Squad** with language‑specific assistants. See: [Squad - Multilingual Support](/squads/examples/multilingual-support). diff --git a/fern/workflows/examples/property-management.mdx b/fern/workflows/examples/property-management.mdx index 6b356b238..eae507910 100644 --- a/fern/workflows/examples/property-management.mdx +++ b/fern/workflows/examples/property-management.mdx @@ -10,6 +10,8 @@ description: Build a voice AI property management system with dynamic call routi +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. + This example uses Workflows. For new builds, use **Squads** with a router assistant and domain specialists. See: [Squad - Property Management Routing](/squads/examples/property-management). diff --git a/fern/workflows/overview.mdx b/fern/workflows/overview.mdx index e4bb2b8a2..43e6af78e 100644 --- a/fern/workflows/overview.mdx +++ b/fern/workflows/overview.mdx @@ -5,17 +5,9 @@ slug: workflows/overview --- -We no longer recommend Workflows for new builds. Prefer **Assistants** or **Squads** depending on complexity. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). This page is retained for legacy reference. - -Why We’ve Moved Away from Workflows - -While the Workflows product is fully built, we’ve found that current AI systems aren’t yet capable of acting as truly autonomous agents that can: - -1. Maintain awareness of the current node’s instructions -2. Understand all possible next steps and the conditions required to reach them - -In contrast, the Squads pattern has consistently led to better results for customers. We’re now focusing on improving the ergonomics and developer experience around Squads to make this approach even more effective. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +We no longer recommend Workflows for new builds. Prefer **Assistants** or **Squads** depending on complexity. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). This page is retained for legacy reference. ## Introduction diff --git a/fern/workflows/quickstart.mdx b/fern/workflows/quickstart.mdx index 8183f0dcb..3ed1b009f 100644 --- a/fern/workflows/quickstart.mdx +++ b/fern/workflows/quickstart.mdx @@ -6,6 +6,8 @@ description: Build a simple agent that greets users and gathers basic informatio --- +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. + We no longer recommend Workflows for new builds. Use **Assistants** for most cases or **Squads** for multi-assistant setups. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). Existing workflow content remains for reference. From 1f1545ab51350cc797969bb2489feedd7cfe4f26 Mon Sep 17 00:00:00 2001 From: betzlermeow Date: Mon, 29 Jun 2026 12:22:56 -0700 Subject: [PATCH 2/4] docs: clarify Workflows retirement banner copy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Reword the retirement banners to be clearer and less awkward: - State plainly that new workflows can no longer be created on the dashboard (replacing the "don't create — even though the dashboard still allows it" phrasing). - Point migration at Assistants or Squads, not just Squads. - Drop the redundant "we no longer recommend" lead-in and the "retained for reference" trailers from the overview, quickstart, and intro banners. Co-Authored-By: Claude Opus 4.8 --- fern/workflows.mdx | 6 +++--- fern/workflows/examples/appointment-scheduling.mdx | 2 +- fern/workflows/examples/clinic-triage-scheduling.mdx | 2 +- fern/workflows/examples/ecommerce-order-management.mdx | 2 +- fern/workflows/examples/lead-qualification.mdx | 2 +- fern/workflows/examples/multilingual-support.mdx | 2 +- fern/workflows/examples/property-management.mdx | 2 +- fern/workflows/overview.mdx | 4 ++-- fern/workflows/quickstart.mdx | 4 ++-- 9 files changed, 13 insertions(+), 13 deletions(-) diff --git a/fern/workflows.mdx b/fern/workflows.mdx index 1e6600306..96e97fb41 100644 --- a/fern/workflows.mdx +++ b/fern/workflows.mdx @@ -5,9 +5,9 @@ slug: workflows --- -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -We no longer recommend Workflows for new builds. Prefer **Assistants** or **Squads** depending on complexity. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). This page is retained for legacy reference. +Prefer **Assistants** or **Squads** depending on complexity. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). Workflows is a new way to build conversational AI. It allows you to break down AI conversations into discrete steps, and then orchestrate those steps in a way that is easy to manage and modify. @@ -15,7 +15,7 @@ Workflows is a new way to build conversational AI. It allows you to break down A ## Creating Your First Workflow -The steps below are retained for legacy reference only. **Don't create new workflows** — the dashboard still allows it, but new builds should use [Assistants](/assistants/dynamic-variables) or [Squads](/squads) instead. +The steps below are retained for legacy reference only. You can no longer create new workflows on the dashboard — build with [Assistants](/assistants/dynamic-variables) or [Squads](/squads) instead. Begin by creating an assistant on the Assistants page and providing the required information, such as the assistant's name and capabilities. Once your assistant is set up, switch the model provider to Vapi and click "Create Workflow" when prompted. A modal will appear offering you the option to create a new workflow or attach to an existing one. Choose the appropriate option to proceed to the Workflow Builder. diff --git a/fern/workflows/examples/appointment-scheduling.mdx b/fern/workflows/examples/appointment-scheduling.mdx index 9b42931be..cedcd0a06 100644 --- a/fern/workflows/examples/appointment-scheduling.mdx +++ b/fern/workflows/examples/appointment-scheduling.mdx @@ -6,7 +6,7 @@ description: Build a voice AI appointment scheduling workflow with calendar inte --- -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. This example uses Workflows. For new builds, use **Assistants** or **Squads**. See the updated guides: [Assistant - Appointment Scheduling](/assistants/examples/appointment-scheduling) or [Squads](/squads). diff --git a/fern/workflows/examples/clinic-triage-scheduling.mdx b/fern/workflows/examples/clinic-triage-scheduling.mdx index 2d9a66c72..d7bca39fd 100644 --- a/fern/workflows/examples/clinic-triage-scheduling.mdx +++ b/fern/workflows/examples/clinic-triage-scheduling.mdx @@ -6,7 +6,7 @@ description: Build a voice AI clinic workflow with medical triage protocols, app --- -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. This example uses Workflows. For new builds, use **Squads** for multi-assistant triage and scheduling. See: [Squad - Clinic Triage & Scheduling](/squads/examples/clinic-triage-scheduling). diff --git a/fern/workflows/examples/ecommerce-order-management.mdx b/fern/workflows/examples/ecommerce-order-management.mdx index ad3e44cee..a921ad793 100644 --- a/fern/workflows/examples/ecommerce-order-management.mdx +++ b/fern/workflows/examples/ecommerce-order-management.mdx @@ -6,7 +6,7 @@ description: Build a voice AI e-commerce workflow with order tracking, return pr --- -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. This example uses Workflows. For new builds, use **Squads** with specialized assistants for orders, returns, and VIP support. See: [Squad - E‑commerce Order Management](/squads/examples/ecommerce-order-management). diff --git a/fern/workflows/examples/lead-qualification.mdx b/fern/workflows/examples/lead-qualification.mdx index 012e80f56..e42875800 100644 --- a/fern/workflows/examples/lead-qualification.mdx +++ b/fern/workflows/examples/lead-qualification.mdx @@ -6,7 +6,7 @@ description: Build a voice AI outbound sales workflow with lead qualification, C --- -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. This example uses Workflows. For new builds, use **Assistants** or **Squads**. See: [Assistant - Lead Qualification](/assistants/examples/lead-qualification) and [Squads](/squads). diff --git a/fern/workflows/examples/multilingual-support.mdx b/fern/workflows/examples/multilingual-support.mdx index fff3d7c5c..327f284ed 100644 --- a/fern/workflows/examples/multilingual-support.mdx +++ b/fern/workflows/examples/multilingual-support.mdx @@ -6,7 +6,7 @@ description: Build a multilingual voice AI customer support workflow with langua --- -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. This example uses Workflows. For new builds, use a **Squad** with language‑specific assistants. See: [Squad - Multilingual Support](/squads/examples/multilingual-support). diff --git a/fern/workflows/examples/property-management.mdx b/fern/workflows/examples/property-management.mdx index eae507910..ac27bd3c8 100644 --- a/fern/workflows/examples/property-management.mdx +++ b/fern/workflows/examples/property-management.mdx @@ -10,7 +10,7 @@ description: Build a voice AI property management system with dynamic call routi -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. This example uses Workflows. For new builds, use **Squads** with a router assistant and domain specialists. See: [Squad - Property Management Routing](/squads/examples/property-management). diff --git a/fern/workflows/overview.mdx b/fern/workflows/overview.mdx index 43e6af78e..a30aa75d8 100644 --- a/fern/workflows/overview.mdx +++ b/fern/workflows/overview.mdx @@ -5,9 +5,9 @@ slug: workflows/overview --- -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -We no longer recommend Workflows for new builds. Prefer **Assistants** or **Squads** depending on complexity. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). This page is retained for legacy reference. +Prefer **Assistants** or **Squads** depending on complexity. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). ## Introduction diff --git a/fern/workflows/quickstart.mdx b/fern/workflows/quickstart.mdx index 3ed1b009f..37251a12b 100644 --- a/fern/workflows/quickstart.mdx +++ b/fern/workflows/quickstart.mdx @@ -6,9 +6,9 @@ description: Build a simple agent that greets users and gathers basic informatio --- -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. **Don't create new workflows** — even though the dashboard still allows it. [Migrate to Squads](/workflows/legacy-migration) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -We no longer recommend Workflows for new builds. Use **Assistants** for most cases or **Squads** for multi-assistant setups. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). Existing workflow content remains for reference. +Use **Assistants** for most cases or **Squads** for multi-assistant setups. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). ## Overview From ab516a2cc6ac7fcc1f69a2ea55184aca0c63b4c2 Mon Sep 17 00:00:00 2001 From: betzlermeow Date: Mon, 29 Jun 2026 12:28:39 -0700 Subject: [PATCH 3/4] docs: make example-page Workflows notices firm and dated The example-specific line read as a soft suggestion ("This example uses Workflows. For new builds, use...") with no deadline. Reword it on all six example pages to state plainly that the example stops working after the August 18, 2026 retirement date and to migrate before then, keeping each page's specific Assistant/Squad replacement link. Co-Authored-By: Claude Opus 4.8 --- fern/workflows/examples/appointment-scheduling.mdx | 2 +- fern/workflows/examples/clinic-triage-scheduling.mdx | 2 +- fern/workflows/examples/ecommerce-order-management.mdx | 2 +- fern/workflows/examples/lead-qualification.mdx | 2 +- fern/workflows/examples/multilingual-support.mdx | 2 +- fern/workflows/examples/property-management.mdx | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/fern/workflows/examples/appointment-scheduling.mdx b/fern/workflows/examples/appointment-scheduling.mdx index cedcd0a06..cf9ce3f9f 100644 --- a/fern/workflows/examples/appointment-scheduling.mdx +++ b/fern/workflows/examples/appointment-scheduling.mdx @@ -8,7 +8,7 @@ description: Build a voice AI appointment scheduling workflow with calendar inte Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -This example uses Workflows. For new builds, use **Assistants** or **Squads**. See the updated guides: [Assistant - Appointment Scheduling](/assistants/examples/appointment-scheduling) or [Squads](/squads). +**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Assistant - Appointment Scheduling](/assistants/examples/appointment-scheduling) or [Squads](/squads) instead, and migrate any existing workflow before the retirement date. ## Overview diff --git a/fern/workflows/examples/clinic-triage-scheduling.mdx b/fern/workflows/examples/clinic-triage-scheduling.mdx index d7bca39fd..8d7174f74 100644 --- a/fern/workflows/examples/clinic-triage-scheduling.mdx +++ b/fern/workflows/examples/clinic-triage-scheduling.mdx @@ -8,7 +8,7 @@ description: Build a voice AI clinic workflow with medical triage protocols, app Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -This example uses Workflows. For new builds, use **Squads** for multi-assistant triage and scheduling. See: [Squad - Clinic Triage & Scheduling](/squads/examples/clinic-triage-scheduling). +**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Squad - Clinic Triage & Scheduling](/squads/examples/clinic-triage-scheduling) instead, and migrate any existing workflow before the retirement date. ## Overview diff --git a/fern/workflows/examples/ecommerce-order-management.mdx b/fern/workflows/examples/ecommerce-order-management.mdx index a921ad793..1a13532a3 100644 --- a/fern/workflows/examples/ecommerce-order-management.mdx +++ b/fern/workflows/examples/ecommerce-order-management.mdx @@ -8,7 +8,7 @@ description: Build a voice AI e-commerce workflow with order tracking, return pr Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -This example uses Workflows. For new builds, use **Squads** with specialized assistants for orders, returns, and VIP support. See: [Squad - E‑commerce Order Management](/squads/examples/ecommerce-order-management). +**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Squad - E‑commerce Order Management](/squads/examples/ecommerce-order-management) instead, and migrate any existing workflow before the retirement date. ## Overview diff --git a/fern/workflows/examples/lead-qualification.mdx b/fern/workflows/examples/lead-qualification.mdx index e42875800..431083c53 100644 --- a/fern/workflows/examples/lead-qualification.mdx +++ b/fern/workflows/examples/lead-qualification.mdx @@ -8,7 +8,7 @@ description: Build a voice AI outbound sales workflow with lead qualification, C Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -This example uses Workflows. For new builds, use **Assistants** or **Squads**. See: [Assistant - Lead Qualification](/assistants/examples/lead-qualification) and [Squads](/squads). +**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Assistant - Lead Qualification](/assistants/examples/lead-qualification) or [Squads](/squads) instead, and migrate any existing workflow before the retirement date. ## Overview diff --git a/fern/workflows/examples/multilingual-support.mdx b/fern/workflows/examples/multilingual-support.mdx index 327f284ed..197ce89e4 100644 --- a/fern/workflows/examples/multilingual-support.mdx +++ b/fern/workflows/examples/multilingual-support.mdx @@ -8,7 +8,7 @@ description: Build a multilingual voice AI customer support workflow with langua Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -This example uses Workflows. For new builds, use a **Squad** with language‑specific assistants. See: [Squad - Multilingual Support](/squads/examples/multilingual-support). +**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Squad - Multilingual Support](/squads/examples/multilingual-support) instead, and migrate any existing workflow before the retirement date. ## Overview diff --git a/fern/workflows/examples/property-management.mdx b/fern/workflows/examples/property-management.mdx index ac27bd3c8..e47899dfc 100644 --- a/fern/workflows/examples/property-management.mdx +++ b/fern/workflows/examples/property-management.mdx @@ -12,7 +12,7 @@ description: Build a voice AI property management system with dynamic call routi Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -This example uses Workflows. For new builds, use **Squads** with a router assistant and domain specialists. See: [Squad - Property Management Routing](/squads/examples/property-management). +**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Squad - Property Management Routing](/squads/examples/property-management) instead, and migrate any existing workflow before the retirement date. ## Overview From 8660ab006a9a0cf558f13725a27e81ebb02a5d24 Mon Sep 17 00:00:00 2001 From: betzlermeow Date: Mon, 29 Jun 2026 13:00:09 -0700 Subject: [PATCH 4/4] docs: standardize Workflows retirement banner and hide legacy intro page - Use one consistent retirement banner across all Workflows pages. - Keep a short link to the Assistant/Squad equivalent on each example. - Hide the legacy Workflows intro page. Co-Authored-By: Claude Opus 4.8 --- fern/workflows.mdx | 3 +-- fern/workflows/examples/appointment-scheduling.mdx | 2 +- fern/workflows/examples/clinic-triage-scheduling.mdx | 2 +- fern/workflows/examples/ecommerce-order-management.mdx | 2 +- fern/workflows/examples/lead-qualification.mdx | 2 +- fern/workflows/examples/multilingual-support.mdx | 2 +- fern/workflows/examples/property-management.mdx | 2 +- fern/workflows/legacy-migration.mdx | 2 +- fern/workflows/overview.mdx | 2 -- fern/workflows/quickstart.mdx | 2 -- 10 files changed, 8 insertions(+), 13 deletions(-) diff --git a/fern/workflows.mdx b/fern/workflows.mdx index 96e97fb41..8a4617b19 100644 --- a/fern/workflows.mdx +++ b/fern/workflows.mdx @@ -2,12 +2,11 @@ title: Introduction to Workflows subtitle: Break down AI conversations into a visual workflow made up of discrete steps ("nodes") and branches between them ("edges"). slug: workflows +hidden: true --- Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. - -Prefer **Assistants** or **Squads** depending on complexity. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). Workflows is a new way to build conversational AI. It allows you to break down AI conversations into discrete steps, and then orchestrate those steps in a way that is easy to manage and modify. diff --git a/fern/workflows/examples/appointment-scheduling.mdx b/fern/workflows/examples/appointment-scheduling.mdx index cf9ce3f9f..e7b5c4638 100644 --- a/fern/workflows/examples/appointment-scheduling.mdx +++ b/fern/workflows/examples/appointment-scheduling.mdx @@ -8,7 +8,7 @@ description: Build a voice AI appointment scheduling workflow with calendar inte Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Assistant - Appointment Scheduling](/assistants/examples/appointment-scheduling) or [Squads](/squads) instead, and migrate any existing workflow before the retirement date. +See the [Assistant - Appointment Scheduling](/assistants/examples/appointment-scheduling) equivalent, or [Squads](/squads). ## Overview diff --git a/fern/workflows/examples/clinic-triage-scheduling.mdx b/fern/workflows/examples/clinic-triage-scheduling.mdx index 8d7174f74..8e7a1eb5b 100644 --- a/fern/workflows/examples/clinic-triage-scheduling.mdx +++ b/fern/workflows/examples/clinic-triage-scheduling.mdx @@ -8,7 +8,7 @@ description: Build a voice AI clinic workflow with medical triage protocols, app Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Squad - Clinic Triage & Scheduling](/squads/examples/clinic-triage-scheduling) instead, and migrate any existing workflow before the retirement date. +See the [Squad - Clinic Triage & Scheduling](/squads/examples/clinic-triage-scheduling) equivalent. ## Overview diff --git a/fern/workflows/examples/ecommerce-order-management.mdx b/fern/workflows/examples/ecommerce-order-management.mdx index 1a13532a3..d83c16f46 100644 --- a/fern/workflows/examples/ecommerce-order-management.mdx +++ b/fern/workflows/examples/ecommerce-order-management.mdx @@ -8,7 +8,7 @@ description: Build a voice AI e-commerce workflow with order tracking, return pr Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Squad - E‑commerce Order Management](/squads/examples/ecommerce-order-management) instead, and migrate any existing workflow before the retirement date. +See the [Squad - E‑commerce Order Management](/squads/examples/ecommerce-order-management) equivalent. ## Overview diff --git a/fern/workflows/examples/lead-qualification.mdx b/fern/workflows/examples/lead-qualification.mdx index 431083c53..3f10beba1 100644 --- a/fern/workflows/examples/lead-qualification.mdx +++ b/fern/workflows/examples/lead-qualification.mdx @@ -8,7 +8,7 @@ description: Build a voice AI outbound sales workflow with lead qualification, C Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Assistant - Lead Qualification](/assistants/examples/lead-qualification) or [Squads](/squads) instead, and migrate any existing workflow before the retirement date. +See the [Assistant - Lead Qualification](/assistants/examples/lead-qualification) equivalent, or [Squads](/squads). ## Overview diff --git a/fern/workflows/examples/multilingual-support.mdx b/fern/workflows/examples/multilingual-support.mdx index 197ce89e4..e36339a09 100644 --- a/fern/workflows/examples/multilingual-support.mdx +++ b/fern/workflows/examples/multilingual-support.mdx @@ -8,7 +8,7 @@ description: Build a multilingual voice AI customer support workflow with langua Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Squad - Multilingual Support](/squads/examples/multilingual-support) instead, and migrate any existing workflow before the retirement date. +See the [Squad - Multilingual Support](/squads/examples/multilingual-support) equivalent. ## Overview diff --git a/fern/workflows/examples/property-management.mdx b/fern/workflows/examples/property-management.mdx index e47899dfc..d4f6afc6f 100644 --- a/fern/workflows/examples/property-management.mdx +++ b/fern/workflows/examples/property-management.mdx @@ -12,7 +12,7 @@ description: Build a voice AI property management system with dynamic call routi Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. -**This example is built on Workflows and will stop working after August 18, 2026.** Don't use it for new projects — build with [Squad - Property Management Routing](/squads/examples/property-management) instead, and migrate any existing workflow before the retirement date. +See the [Squad - Property Management Routing](/squads/examples/property-management) equivalent. ## Overview diff --git a/fern/workflows/legacy-migration.mdx b/fern/workflows/legacy-migration.mdx index 9cd4605c9..6a935b0ff 100644 --- a/fern/workflows/legacy-migration.mdx +++ b/fern/workflows/legacy-migration.mdx @@ -6,7 +6,7 @@ description: Migrate your Vapi Workflows to Squads before Workflows is retired o --- -Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. Migrate to [Squads](/squads) before then to avoid disruption. +Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. Migrate existing workflows to **Assistants** or **Squads** before the retirement date to avoid disruption. ## What's changing diff --git a/fern/workflows/overview.mdx b/fern/workflows/overview.mdx index a30aa75d8..a3aefe8b5 100644 --- a/fern/workflows/overview.mdx +++ b/fern/workflows/overview.mdx @@ -6,8 +6,6 @@ slug: workflows/overview Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. - -Prefer **Assistants** or **Squads** depending on complexity. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). ## Introduction diff --git a/fern/workflows/quickstart.mdx b/fern/workflows/quickstart.mdx index 37251a12b..6215e7e97 100644 --- a/fern/workflows/quickstart.mdx +++ b/fern/workflows/quickstart.mdx @@ -7,8 +7,6 @@ description: Build a simple agent that greets users and gathers basic informatio Workflows will be retired on **August 18, 2026**. From August 19, 2026 onward, existing workflows will no longer run. You will no longer be able to create new workflows on the dashboard. [Migrate existing workflows](/workflows/legacy-migration) to **Assistants** or **Squads** before the retirement date to avoid disruption. - -Use **Assistants** for most cases or **Squads** for multi-assistant setups. See [Assistants](/assistants/dynamic-variables) and [Squads](/squads). ## Overview