Merge branch 'main' into patch-1

stephenvapiai · web-flow · commit cd37d0f78ff6 · 2026-07-06T13:12:50.000-07:00
diff --git a/fern/changelog/2026-06-29.mdx b/fern/changelog/2026-06-29.mdx
@@ -0,0 +1,12 @@
+# What's New: Week of June 29, 2026
+
+1. **OpenAI Realtime v2**: OpenAI's latest [Realtime v2](https://docs.vapi.ai/openai-realtime) model is now available for assistants.
+
+2. **AI-Generated Tool Failure and Completion Messages**: You can now set `role: 'system'` on request-failed [tool messages](https://docs.vapi.ai/tools/custom-tools), and the dashboard has a new UI for configuring AI-generated messages when tools fail or complete. This gives assistants more natural responses when tools hit errors.
+
+3. **Call Logs Improvements**:
+    - Significant latency improvements across both the dashboard and the `/calls` API endpoints.
+    - The call detail flyout now shows which assistant or squad handled the call, includes a link to the assistant or squad, and indicates which phone number was used.
+    - In squad or handoff calls, transcript messages now show which assistant said what, making it easier to trace conversation flow.
+
+4. **MCP Child Tools in Dashboard**: When you connect an [MCP server](https://docs.vapi.ai/sdk/mcp-server), the dashboard tool form now lists all child tools it discovers, so you can see exactly what capabilities your MCP server exposes.
diff --git a/fern/fern.config.json b/fern/fern.config.json
@@ -1,4 +1,4 @@
 {
   "organization": "vapi",
-  "version": "5.46.1"
+  "version": "5.59.0"
 }
diff --git a/fern/snippets/faq-snippet.mdx b/fern/snippets/faq-snippet.mdx
@@ -32,7 +32,7 @@ No matter what, some cost is inescapable (in money, time, etc) to solve this cha
 
 
 
-To learn more about Vapi’s pricing, you can visit our [pricing page](/pricing).
+To learn more about Vapi’s pricing, you can visit our [pricing page](https://vapi.ai/pricing).
 
 
   </Accordion>
diff --git a/fern/workflows.mdx b/fern/workflows.mdx
@@ -2,16 +2,21 @@
 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
 ---
 
-<Success intent="launch">
-  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. 
-</Success>
+<Warning>
+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.
+</Warning>
 
 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
 
+<Warning>
+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.
+</Warning>
+
 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.
 
 <Steps>
diff --git a/fern/workflows/examples/appointment-scheduling.mdx b/fern/workflows/examples/appointment-scheduling.mdx
@@ -6,7 +6,9 @@ description: Build a voice AI appointment scheduling workflow with calendar inte
 ---
 
 <Warning>
-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).
+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.
+
+See the [Assistant - Appointment Scheduling](/assistants/examples/appointment-scheduling) equivalent, or [Squads](/squads).
 </Warning>
 
 ## Overview
diff --git a/fern/workflows/examples/clinic-triage-scheduling.mdx b/fern/workflows/examples/clinic-triage-scheduling.mdx
@@ -6,7 +6,9 @@ description: Build a voice AI clinic workflow with medical triage protocols, app
 ---
 
 <Warning>
-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).
+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.
+
+See the [Squad - Clinic Triage & Scheduling](/squads/examples/clinic-triage-scheduling) equivalent.
 </Warning>
 
 ## Overview
diff --git a/fern/workflows/examples/ecommerce-order-management.mdx b/fern/workflows/examples/ecommerce-order-management.mdx
@@ -6,7 +6,9 @@ description: Build a voice AI e-commerce workflow with order tracking, return pr
 ---
 
 <Warning>
-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).
+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.
+
+See the [Squad - E‑commerce Order Management](/squads/examples/ecommerce-order-management) equivalent.
 </Warning>
 
 ## Overview
diff --git a/fern/workflows/examples/lead-qualification.mdx b/fern/workflows/examples/lead-qualification.mdx
@@ -6,7 +6,9 @@ description: Build a voice AI outbound sales workflow with lead qualification, C
 ---
 
 <Warning>
-This example uses Workflows. For new builds, use **Assistants** or **Squads**. See: [Assistant - Lead Qualification](/assistants/examples/lead-qualification) and [Squads](/squads).
+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.
+
+See the [Assistant - Lead Qualification](/assistants/examples/lead-qualification) equivalent, or [Squads](/squads).
 </Warning>
 
 ## Overview
diff --git a/fern/workflows/examples/multilingual-support.mdx b/fern/workflows/examples/multilingual-support.mdx
@@ -6,7 +6,9 @@ description: Build a multilingual voice AI customer support workflow with langua
 ---
 
 <Warning>
-This example uses Workflows. For new builds, use a **Squad** with language‑specific assistants. See: [Squad - Multilingual Support](/squads/examples/multilingual-support).
+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.
+
+See the [Squad - Multilingual Support](/squads/examples/multilingual-support) equivalent.
 </Warning>
 
 ## Overview
diff --git a/fern/workflows/examples/property-management.mdx b/fern/workflows/examples/property-management.mdx
@@ -10,7 +10,9 @@ description: Build a voice AI property management system with dynamic call routi
 </Frame>
 
 <Warning>
-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).
+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.
+
+See the [Squad - Property Management Routing](/squads/examples/property-management) equivalent.
 </Warning>
 
 ## Overview
diff --git 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
 ---
 
 <Warning>
-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.
 </Warning>
 
 ## What's changing
diff --git a/fern/workflows/overview.mdx b/fern/workflows/overview.mdx
@@ -5,17 +5,7 @@ slug: workflows/overview
 ---
 
 <Warning>
-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. 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.
 </Warning>
 
 ## Introduction
diff --git a/fern/workflows/quickstart.mdx b/fern/workflows/quickstart.mdx
@@ -6,7 +6,7 @@ description: Build a simple agent that greets users and gathers basic informatio
 ---
 
 <Warning>
-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.
+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.
 </Warning>
 
 ## Overview

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`	`1`	`{`
`2`	`2`	`"organization": "vapi",`
`3`		`- "version": "5.46.1"`
	`3`	`+ "version": "5.59.0"`
`4`	`4`	`}`
Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,7 @@ No matter what, some cost is inescapable (in money, time, etc) to solve this cha`
`32`	`32`
`33`	`33`
`34`	`34`
`35`		`-To learn more about Vapi’s pricing, you can visit our [pricing page](/pricing).`
	`35`	`+To learn more about Vapi’s pricing, you can visit our [pricing page](https://vapi.ai/pricing).`
`36`	`36`
`37`	`37`
`38`	`38`	`</Accordion>`