stephenvapiai · Oct 27, 2026 · Oct 27, 2026
diff --git a/fern/advanced/sip/sip-plivo.mdx b/fern/advanced/sip/sip-plivo.mdx
@@ -136,7 +136,7 @@ Indian phone numbers cannot be used with Plivo on Vapi due to TRAI regulations.
         }'
         ```
         2. Your response will look like this, note the phone number ID from the response for making calls.
-        ```bash
+        ```json
         {
           "id": "eba2fb13-259f-4123-abfa-xxxxxxxxxxxxxxx",
           "orgId": "489ea344-c56f-4243-8723-b28362cd5a5c",

diff --git a/fern/advanced/sip/sip.mdx b/fern/advanced/sip/sip.mdx
@@ -79,7 +79,7 @@ If your SIP provider or firewall requires IP allowlisting, use the signalling IP
     To fill template variables, send custom SIP headers with your call.
 
     For example, to fill the `first_name` variable, send a SIP header:
-    ```
+    ```text
     x-first_name: John
     ```
     Header names are case-insensitive (e.g., `X-First_Name`, `x-first_name`, and `X-FIRST_NAME` all work).

diff --git a/fern/assistants/email-address-reading.mdx b/fern/assistants/email-address-reading.mdx
@@ -60,7 +60,7 @@ The email formatter runs automatically with no configuration needed. However, yo
 
 ### Configuration path
 
-```
+```text
 assistant.voice.chunkPlan.formatPlan
 ```
 

diff --git a/fern/assistants/examples/multilingual-agent.mdx b/fern/assistants/examples/multilingual-agent.mdx
@@ -27,7 +27,7 @@ The files are a snapshot, not a live customer database or product catalog.
 * One Query tool for customer records, product information, and support article summaries
 
 <Note>
-**Alternative Approach**: For a more structured multilingual experience with explicit language selection, see our [Squad-based multilingual support](../../squads/examples/multilingual-support) that guides customers through language selection and dedicated conversation paths.
+**Alternative Approach**: For a more structured multilingual experience with explicit language selection, see our [Squad-based multilingual support](/squads/examples/multilingual-support) that guides customers through language selection and dedicated conversation paths.
 </Note>
 
 ## Prerequisites

diff --git a/fern/assistants/retrieve-call-artifacts.mdx b/fern/assistants/retrieve-call-artifacts.mdx
@@ -29,7 +29,7 @@ Follow the [Vapi API key guide](/security-and-privacy/api-keys) to create, view,
 
 To download or retrieve a recording or log file, send your Private API Key in the `Authorization` header:
 
-```
+```text
 Authorization: Bearer <PRIVATE_API_KEY>
 ```
 

diff --git a/fern/calls/call-outbound.mdx b/fern/calls/call-outbound.mdx
@@ -28,7 +28,7 @@ You can place an outbound call from one of your phone numbers using the [`/call`
 
 Provide your authorization token and now we're ready to issue the API call!
 
-```jsx
+```json
 {
     "assistantId": "assistant-id",
     "phoneNumberId": "phone-number-id",
@@ -44,7 +44,7 @@ By default, an outbound call placed with a saved `assistantId` uses the assistan
 
 To pin the call to a specific published version instead, add `assistantVersion` (a version label like `v3`) alongside the `assistantId`. Version pinning works only with a saved `assistantId`; it is rejected with a transient `assistant`.
 
-```jsx
+```json
 {
     "assistantId": "assistant-id",
     "assistantVersion": "v3",
@@ -63,7 +63,7 @@ To schedule a call for the future, use the [`schedulePlan`](/api-reference/calls
 
 When you schedule a call, we will save the Assistant, Phone Number, and Customer Number resources and refetch them at the time of the call. If you choose to provide a saved assistant through `assistantId`, we will pick up the most up-to-date version of your assistant at the call time. Likewise, if you delete your saved assistant, the call will fail! To ensure the call is issued with a static version of an assistant, pass it as a transient assistant through the `assistant` parameter.
 
-```jsx
+```json
 {
     "assistantId": "assistant-id",
     "phoneNumberId": "phone-number-id",
@@ -82,7 +82,7 @@ To call more than one number at a time, use the [`customers`](/api-reference/cal
 
 Use both `customers` and `schedulePlan` together to schedule batched calls.
 
-```jsx
+```json
 {
     "assistantId": "assistant-id",
     "phoneNumberId": "phone-number-id",

diff --git a/fern/cli/authentication.mdx b/fern/cli/authentication.mdx
@@ -107,7 +107,7 @@ vapi auth status
 ```
 
 Output:
-```
+```text
 🔐 Vapi Authentication Status
 
 Active Account:

diff --git a/fern/cli/mcp-integration.mdx b/fern/cli/mcp-integration.mdx
@@ -231,7 +231,7 @@ vapi mcp status
 ```
 
 Output:
-```
+```text
 MCP Configuration Status:
 ✓ Cursor: Configured (.cursor/mcp.json)
 ✗ Windsurf: Not configured

diff --git a/fern/customization/custom-transcriber.mdx b/fern/customization/custom-transcriber.mdx
@@ -450,7 +450,7 @@ You'll learn how to:
 - **Streaming support requirement:**  
   The custom transcriber must support streaming. Vapi sends continuous audio data over the WebSocket, and your server must handle this stream in real time.
 - **Authentication:**  
-  For secure transcriber endpoints, use **Custom Credentials** with `credentialId`. Create [Custom Credentials](../../server-url/server-authentication) in the dashboard to manage Bearer Token, OAuth 2.0, or HMAC authentication. For backward compatibility, the legacy `secret` field is still supported and sends the value as an `x-vapi-secret` HTTP header.
+  For secure transcriber endpoints, use **Custom Credentials** with `credentialId`. Create [Custom Credentials](/server-url/server-authentication) in the dashboard to manage Bearer Token, OAuth 2.0, or HMAC authentication. For backward compatibility, the legacy `secret` field is still supported and sends the value as an `x-vapi-secret` HTTP header.
 - **Buffering:**  
   The solution buffers PCM audio and performs simple validation (e.g. ensuring stereo PCM data length is a multiple of 4). If the audio data is malformed, it is trimmed to a valid length.
 - **Channel detection:**  

diff --git a/fern/customization/custom-tts.mdx b/fern/customization/custom-tts.mdx
@@ -76,7 +76,7 @@ Create authentication credentials in the dashboard and reference them by ID:
 </CodeBlocks>
 
 <Note>
-Create [Custom Credentials](../../server-url/server-authentication) in the Vapi dashboard for better security and credential management.
+Create [Custom Credentials](/server-url/server-authentication) in the Vapi dashboard for better security and credential management.
 </Note>
 
 ### Legacy Authentication Methods

diff --git a/fern/customization/jwt-authentication.mdx b/fern/customization/jwt-authentication.mdx
@@ -135,7 +135,7 @@ fetchData().catch(console.error);
 
 If you set the scope to `public`, you can use it to make authenticated API requests using the Vapi Web Client.
 
-```
+```javascript
 import Vapi from '@vapi-ai/web';
 
 const vapi = new Vapi('your-jwt-token');

diff --git a/fern/customization/multilingual.mdx b/fern/customization/multilingual.mdx
@@ -218,7 +218,7 @@ Create system prompts that explicitly list supported languages and handle multip
 <Tabs>
   <Tab title="Dashboard">
     1. In the **Model** section, update your system prompt to explicitly list supported languages:
-    ```
+    ```text
     You are a helpful assistant that can communicate in English, Spanish, and French.
 
     Language Instructions:
@@ -321,7 +321,7 @@ Configure greeting messages that work across multiple languages.
 <Tabs>
   <Tab title="Dashboard">
     1. In the **First message** field, enter a multilingual greeting:
-    ```
+    ```text
     Hello! I can assist you in English, Spanish, or French. How can I help you today?
     ```
     2. Select **Publish**, review the changes, select **Next**, then select **Publish** to apply the draft.

diff --git a/fern/customization/speech-configuration.mdx b/fern/customization/speech-configuration.mdx
@@ -69,7 +69,7 @@ This plan defines the parameters for when the assistant begins speaking after th
   **LiveKit Smart Endpointing Configuration:**
   When using LiveKit, you can customize the `waitFunction` parameter which determines how long the bot will wait to start speaking based on the likelihood that the user has finished speaking:
 
-  ```
+  ```text
   waitFunction: "200 + 8000 * x"
   ```
 

diff --git a/fern/customization/voice-pipeline-configuration.mdx b/fern/customization/voice-pipeline-configuration.mdx
@@ -107,7 +107,7 @@ For implementation examples, see **[Configuration examples](#configuration-examp
 
 ### Complete processing pipeline
 
-```
+```text
 User Audio → VAD → Transcription → Start Speaking Decision → LLM → TTS → waitSeconds → Assistant Audio
 ```
 
@@ -471,7 +471,7 @@ Final audio delay applied after all processing completes, before the assistant s
 
 `waitSeconds` is applied at the END of the voice pipeline processing:
 
-```
+```text
 Endpointing Triggers → LLM Processes → TTS Generates → waitSeconds Delay → Assistant Speaks
 ```
 
@@ -486,7 +486,7 @@ Endpointing Triggers → LLM Processes → TTS Generates → waitSeconds Delay
 
 Understanding exact timing helps optimize your voice pipeline configuration. This timeline shows what happens at every moment during the conversation flow.
 
-```
+```text
 0.0s: User stops speaking
 0.1s: Smart endpointing evaluation begins
 0.6s: Smart endpointing triggers (varies by waitFunction)
@@ -588,7 +588,7 @@ VAD duration threshold when `numWords = 0`. Determines how long voice activity m
 
 When `numWords = 0`, the voice pipeline uses **Voice Activity Detection (VAD)** instead of waiting for transcription:
 
-```
+```text
 User Starts Speaking → VAD Detects Voice → Continuous for voiceSeconds Duration → Interrupt Assistant
 ```
 
@@ -612,7 +612,7 @@ Duration that blocks all assistant audio output after user interruption, creatin
 
 #### Pipeline timing relationship
 
-```
+```text
 User Interrupts → Assistant Audio Stopped → backoffSeconds Blocks All Output → Ready for New Input
 ```
 
@@ -626,7 +626,7 @@ User Interrupts → Assistant Audio Stopped → backoffSeconds Blocks All Output
 
 **How to read this timeline:** This shows the complete flow from interruption to recovery. Notice how backoffSeconds creates a "quiet period" before normal processing resumes.
 
-```
+```text
 0.0s: Assistant speaking: "I can help you book..."
 1.2s: User interrupts: "Actually, wait"
 1.2s: backoffSeconds (1.0s) starts → All audio blocked
@@ -802,5 +802,5 @@ Now that you understand voice pipeline configuration:
 
 - **[Speech configuration](speech-configuration):** Learn about provider-specific voice settings
 - **[Custom transcriber](custom-transcriber):** Configure transcription providers for your language
-- **[Voice fallback plan](../voice-fallback-plan):** Set up backup voice options
-- **[Debugging voice agents](../debugging):** Troubleshoot voice pipeline issues
+- **[Voice fallback plan](/voice-fallback-plan):** Set up backup voice options
+- **[Debugging voice agents](/debugging):** Troubleshoot voice pipeline issues
diff --git a/fern/issue-reporting.mdx b/fern/issue-reporting.mdx
@@ -70,7 +70,7 @@ When reporting assistant-related issues, always include:
 
 ### Example Report Format
 
-```
+```text
 Call ID: 9ac27e94-74a5-4061-8a0b-3c05389c63bd
 Timestamp: 00:30
 Issue: The assistant paused for 5 seconds before replying
@@ -128,7 +128,7 @@ For problems with the Vapi dashboard interface, configuration screens, or any vi
 
 ### Example Report Format
 
-```
+```text
 URL: https://dashboard.vapi.ai/assistants/create
 Browser: Chrome 120.0.6099.109
 OS: macOS 14.1
@@ -165,7 +165,7 @@ For issues related to your account, billing, login, or organization settings, pr
 
 ### Example Report Format
 
-```
+```text
 Email: user@example.com
 Organization ID: c6fba1b9-3e07-429e-b265-4ce3bbef1627
 Issue: Unable to upgrade to the Pro Success Package - payment processing fails

diff --git a/fern/knowledge-base/knowledge-base.mdx b/fern/knowledge-base/knowledge-base.mdx
@@ -85,7 +85,7 @@ There are two main approaches to creating a Knowledge Base in Vapi:
 1. Instruct your assistant to use the knowledge base when relevant by adding appropriate prompts in your assistant's configuration. This helps ensure the assistant knows when to reference the knowledge base versus using its general knowledge.
 
    For example, if you have a knowledge base about your company's products, you might add this prompt:
-   ```
+   ```text
    When users ask about our products, services, or company information, use the knowledge base to provide accurate details.
    ```
 

diff --git a/fern/observability/boards-quickstart.mdx b/fern/observability/boards-quickstart.mdx
@@ -216,7 +216,7 @@ Build custom metrics using formulas to calculate rates, averages, and more. Form
        - **Query Name**: totalCalls
        - **Metric**: Count of Call ID
     6. Enter formula in the formula editor:
-       ```
+       ```text
        ({{totalBookings}} / {{totalCalls}}) * 100
        ```
     7. Click **Preview** to validate

diff --git a/fern/observability/evals-advanced.mdx b/fern/observability/evals-advanced.mdx
@@ -670,7 +670,7 @@ Choose the right judge type for each scenario:
 
 **Decision tree:**
 
-```
+```text
 Is the exact wording critical?
 ├─ Yes → Use Exact Match
 └─ No → Does it follow a pattern?
@@ -959,7 +959,7 @@ One passing run isn't proof of reliability. Repeat critical or surprising Evals
 
 Track eval executions systematically:
 
-```javascript
+```json
 {
   "timestamp": "2024-01-15T10:30:00Z",
   "evalId": "eval-123",

diff --git a/fern/observability/evals-quickstart.mdx b/fern/observability/evals-quickstart.mdx
@@ -602,7 +602,7 @@ For complex validation criteria beyond pattern matching, use AI-powered judges t
 
 **Template structure:**
 
-```
+```text
 You are an LLM-Judge. Evaluate ONLY the last assistant message in the mock conversation: {{messages[-1]}}.
 
 Include the full conversation history for context: {{messages}}

diff --git a/fern/openai-realtime.mdx b/fern/openai-realtime.mdx
@@ -242,7 +242,7 @@ The system message in your model configuration is automatically optimized for re
 
 Organize your prompts with clear sections for better model comprehension:
 
-```
+```text
 # Role & Objective
 You are a customer service agent for Acme Corp. Your goal is to resolve issues quickly.
 
@@ -270,7 +270,7 @@ politely offer to transfer them to a specialist.
   <Tab title="Speaking Speed">
     Control the model's speaking pace with explicit instructions:
 
-    ```
+    ```text
     ## Pacing
     - Deliver responses at a natural, conversational speed
     - Do not rush through information
@@ -280,7 +280,7 @@ politely offer to transfer them to a specialist.
   <Tab title="Personality">
     Realtime models excel at maintaining consistent personality:
 
-    ```
+    ```text
     ## Personality
     - Warm and approachable like a trusted advisor
     - Professional but not robotic
@@ -290,7 +290,7 @@ politely offer to transfer them to a specialist.
   <Tab title="Conversation Flow">
     Guide natural conversation progression:
 
-    ```
+    ```text
     ## Conversation Flow
     1. Greeting: Welcome caller and ask how you can help
     2. Discovery: Understand their specific needs
-Original file line number
+Diff line change
@@ Expand Up @@
             }'
             ```
 . Your response will look like this, note the phone number ID from the response for making calls.
-            ```bash
+            ```json
             {
               "id": "eba2fb13-259f-4123-abfa-xxxxxxxxxxxxxxx",
               "orgId": "489ea344-c56f-4243-8723-b28362cd5a5c",
@@ Expand Down @@