Added directions for Success Packages (#1220)

Author: stephenvapiai

fern/advanced/sip/sip.mdx

@@ -24,9 +24,9 @@ Use the API base URL, private key, and SIP host from the same Vapi region. Do no
 | United States | `dashboard.vapi.ai` | `https://api.vapi.ai` | `sip.vapi.ai` |
 | European Union | `dashboard.eu.vapi.ai` | `https://api.eu.vapi.ai` | `sip.eu.vapi.ai` |
 
-<Warning>
-Vapi's EU support and self-serve growth are frozen until 2027. Existing EU customers can continue using their accounts, but Vapi is not offering new add-ons and does not guarantee feature parity with the US region. New self-serve customers should [create an account in the US region](https://dashboard.vapi.ai/register). If you require Vapi-hosted EU data residency, [contact Sales](https://vapi.ai/sales) about selective enterprise onboarding.
-</Warning>
+<Note>
+Vapi offers an EU region with EU dashboard, API, and SIP endpoints. For more information, see [EU region and data residency](/security-and-privacy/eu-region).
+</Note>
 
 For existing EU organizations, create the SIP phone number against the EU API with an EU dashboard private key:
 

fern/assistants/call-recording.mdx

@@ -549,9 +549,7 @@ Use artifact data for comprehensive insights:
   </Accordion>
 
   <Accordion title="How long are artifacts stored?">
-    Retention periods vary by plan:
-    - **Pay-As-You-Go:** Up to 30 days for chats and 14 days for calls
-    - **Enterprise:** Configurable retention policies 
+    Retention periods vary by your plan. See [Pricing and Success Packages](/billing/pricing-and-success-packages#whats-included) for what each plan includes. To check your current plan, open **Billing & Payment** in the [Vapi Dashboard](https://dashboard.vapi.ai).
   </Accordion>
 
   <Accordion title="How do artifacts work with squad transfers?">

fern/assistants/examples/inbound-support.mdx

@@ -983,5 +983,5 @@ Consider the reading the following guides to further enhance your assistant:
 * [**Squads**](/squads) - Learn how to compose multiple assistants and transfer seamlessly for complex use cases.
 
 <Callout>
-Need help? Chat with the team on our [Discord](https://discord.com/invite/pUFNcf2WmH) or mention us on [X/Twitter](https://x.com/Vapi_AI).
+Need help? Ask other developers in the [Vapi Discord community](https://discord.gg/v5Ee6FhAZt) or mention us on [X/Twitter](https://x.com/Vapi_AI).
 </Callout>

fern/assistants/examples/multilingual-agent.mdx

@@ -1050,5 +1050,5 @@ Consider reading the following guides to further enhance your multilingual imple
 * [**Function tools**](/tools/custom-tools) - Build advanced multilingual tools and integrations
 
 <Callout>
-Need help with multilingual implementation? Chat with the team on our [Discord](https://discord.com/invite/pUFNcf2WmH) or mention us on [X/Twitter](https://x.com/Vapi_AI).
+Need help with multilingual implementation? Ask other developers in the [Vapi Discord community](https://discord.gg/v5Ee6FhAZt) or mention us on [X/Twitter](https://x.com/Vapi_AI).
 </Callout>

fern/assistants/quickstart.mdx

@@ -158,7 +158,7 @@ By default, when you create an assistant, the transcriber, model, and voice are
       <Step title="Create the phone number">
         Enter a three-digit US area code in **Area Code**, then select **Create**.
 
-        Your first free Vapi number does not require a payment method. To create additional free Vapi numbers, add a payment method. You can create up to five free Vapi numbers in total.
+        Your free Vapi number does not require a payment method. You get one free Vapi number, and your Success Package may include more.
 
         <Warning>
           Free Vapi phone numbers support US area codes only. For international use, import a number from another provider.

fern/assistants/structured-outputs-quickstart.mdx

@@ -927,7 +927,7 @@ Common validation patterns for reliable extraction:
 
 ## Get help
 
-Need assistance? We're here to help:
+Need assistance? Try these resources:
 - [API Documentation](/api-reference)
-- [Discord Community](https://discord.gg/pUFNcf2WmH)
-- [Support](mailto:support@vapi.ai)
+- [Discord Community](https://discord.gg/v5Ee6FhAZt)
+- [Support](/support)

fern/billing/manage-billing-and-credits.mdx

@@ -1,74 +1,107 @@
 ---
-title: "Manage pay-as-you-go billing and credits"
-subtitle: "Add a payment method, buy credits, configure auto reload, and download billing records"
-description: "Manage pay-as-you-go billing in the Vapi Dashboard: add a payment method, buy credits, configure auto reload, and download PDF statements and invoices. See Vapi pricing for rates."
+title: Manage billing and credits
+subtitle: Add a payment method, buy credits, set up auto-reload, and download billing records
+description: "Manage billing in the Vapi Dashboard: add a payment method, buy Vapi credits, configure auto-reload, and download statements and invoices."
 slug: billing/manage-billing-and-credits
 ---
 
-This guide shows you how to set up billing for a pay-as-you-go subscription. By the end, you can fund the subscription and configure automatic credit purchases.
+<Note>
+If your Dashboard shows **Settings → Billing & Add-Ons** instead of **Billing & Payment**, see [Manage pay-as-you-go billing and credits](/billing/manage-pay-as-you-go-billing).
+</Note>
+
+Vapi credits are prepaid funds in US dollars that cover usage-based charges. This guide shows you how to add a payment method, fund your usage, keep your balance funded automatically, and download billing records.
 
 ## Prerequisites
 
 - An **Admin** role in the organization.
 
-## Steps
+## How credits work
 
-<Steps>
-  <Step title="Open the Billing page">
-    Sign in to the [Vapi Dashboard](https://dashboard.vapi.ai), select the organization you want to fund, open **Settings**, then select **Billing & Add-Ons**.
+Credits cover usage-based costs:
 
-    <Frame>
-      <img src="../static/images/billing/billing-navigation.jpg" alt="Billing & Add-Ons selected in the Dashboard Settings navigation" />
-    </Frame>
-  </Step>
+- The per-minute Vapi hosting fee draws down your balance as calls run.
+- Model, voice, transcriber, and telephony costs also draw down your balance.
+
+The Dashboard shows how Success Package and add-on fees are charged before you confirm a purchase. If your credit balance reaches $0 and auto-reload is off, Vapi freezes the subscription. You cannot start new calls or other billable usage until you purchase more credits.
 
-  <Step title="Add a payment method">
-    In **Payment method**, enter the billing email and card details. Select the checkmark beside each field to save it.
+## Add or update a payment method
 
-    To replace a saved card, select the pencil beside **Payment method**, enter the new card details, then select the checkmark.
+Your default card is used for credit purchases, auto-reload, and any recurring charges shown in the Dashboard. Add a card before you buy credits or turn on auto-reload.
 
-    <Frame caption="Billing email blurred for privacy.">
-      <img src="../static/images/billing/billing-payment-method.jpg" alt="Full Payment method block with the billing email blurred, card field, and auto reload controls" />
-    </Frame>
+<Steps>
+  <Step title="Open the Billing page">
+    Sign in to the [Vapi Dashboard](https://dashboard.vapi.ai), make sure the [correct organization](/billing/manage-organizations-and-capacity#switch-organizations) is selected, and open **Billing**.
+  </Step>
+  <Step title="Manage payment methods">
+    Select **Manage payment** to open your saved cards. Add a new card, or select an existing card to set it as the default.
+  </Step>
+  <Step title="Save the card">
+    Enter the card details and confirm.
   </Step>
+</Steps>
 
-  <Step title="Buy credits">
-    At the top of the Billing page, select **Buy credits**. In **Purchase Vapi credits**, enter at least `$10` in **Amount to purchase**, then select **Purchase**.
+## Buy credits
 
-    Complete any verification requested by the card issuer. A successful purchase increases the credit balance and appears as **Finalized** in **Credit purchase history**.
+Buy credits to fund your organization's usage. Credits are added to the organization you have selected, so confirm you are on the [right organization](/billing/manage-organizations-and-capacity#switch-organizations) first.
 
-    <Frame caption="Current balance redacted for privacy.">
-      <img src="../static/images/billing/billing-purchase-credits.jpg" alt="Purchase Vapi credits dialog with the amount to purchase field" />
-    </Frame>
+<Steps>
+  <Step title="Open Buy credits">
+    On the **Billing** page, select **Buy credits**.
+  </Step>
+  <Step title="Choose an amount">
+    Select a preset amount or enter a custom amount. A minimum purchase applies.
   </Step>
+  <Step title="Confirm the purchase">
+    If you have a saved card, confirm to charge it. If you do not, enter card details first. Complete any verification your card issuer requests.
+  </Step>
+  <Step title="Verify the balance">
+    A successful purchase increases your credit balance and appears as **Finalized** in your purchase history.
+  </Step>
+</Steps>
 
-  <Step title="Optional: Configure auto reload">
-    In **Payment method**, turn on **Enable auto reload**. Enter at least `$10` in **Amount to reload**, then enter the balance that should trigger the purchase in **When threshold reaches**.
+## Set up auto-reload
 
-    Select **Save changes**, review the confirmation, then select **Confirm**. If the current balance is at or below the threshold, saving the plan charges the payment method immediately.
+Auto-reload keeps your organization funded so usage is not interrupted. When the credit balance reaches a threshold you set, Vapi automatically purchases the top-up amount you choose.
 
-    <Frame>
-      <img src="../static/images/billing/billing-auto-reload.jpg" alt="Auto reload controls on the live Billing page" />
-    </Frame>
+<Steps>
+  <Step title="Open auto-reload settings">
+    On the **Billing** page, open the auto-reload control.
   </Step>
-
-  <Step title="Verify the billing setup">
-    Confirm that the page shows the saved payment method, updated credit balance, and auto reload settings. Check **Credit purchase history** for a **Finalized** payment.
+  <Step title="Set the top-up and threshold">
+    Turn on auto-reload, enter the amount to add each time, and enter the balance that should trigger a top-up.
+  </Step>
+  <Step title="Save">
+    Save your changes and confirm. If your current balance is already at or below the threshold, saving charges your default card immediately.
   </Step>
 </Steps>
 
-## Download billing records
+<Note>
+With auto-reload off, usage can be interrupted when credits run out. Turn on auto-reload to keep the balance funded.
+</Note>
 
-Select **Download monthly statement** in **Credit purchase history** to create a statement for a selected month.
+## Download statements and invoices
 
-To download an invoice for an eligible payment, select the payment, then select **Download invoice (PDF)**. Enter the requested invoice information and select **Confirm**.
+Download a statement or an invoice from your billing history for your records or accounting.
 
-## Related
+<Steps>
+  <Step title="Download a statement">
+    Open the **Payments** view and select **Download latest statement**. To download a different period, choose the month first.
+  </Step>
+  <Step title="Download an invoice">
+    Select an eligible payment, then select **Download invoice (PDF)** and enter the requested invoice details.
+  </Step>
+</Steps>
 
-<Card title="Vapi pricing" href="https://vapi.ai/pricing">
-  See current credit and per-minute rates on the official pricing page.
-</Card>
+## Related
 
-<Card title="Troubleshoot call errors" href="/calls/troubleshoot-call-errors">
-  Resolve calls blocked by an insufficient credit balance or frozen subscription.
-</Card>
+<CardGroup cols={2}>
+  <Card title="Pricing and Success Packages" icon="fa-light fa-tags" href="/billing/pricing-and-success-packages">
+    Understand Usage only, optional Success Packages, and add-ons.
+  </Card>
+  <Card title="Manage Success Packages and add-ons" icon="fa-light fa-box" href="/billing/manage-packages-and-add-ons">
+    Change your Success Package and buy capacity or compliance add-ons.
+  </Card>
+  <Card title="Vapi pricing" icon="fa-light fa-money-check-dollar" href="https://vapi.ai/pricing">
+    See current credit and per-minute rates on the official pricing page.
+  </Card>
+</CardGroup>

fern/billing/manage-organizations-and-capacity.mdx

@@ -0,0 +1,96 @@
+---
+title: Manage organizations and capacity
+subtitle: Create organizations, understand shared capacity, and resolve capacity before a downgrade
+description: Learn how subscriptions provide organization capacity, how to create, move, and delete organizations, and what to resolve before reducing capacity.
+slug: billing/manage-organizations-and-capacity
+---
+
+A subscription groups usage-based billing, an optional Success Package, add-ons, and one or more organizations. Usage only and each Success Package determine how many organizations the subscription can contain.
+
+## Prerequisites
+
+- An **Admin** role in the organization.
+
+## Organization capacity
+
+Organization capacity is the number of organizations that a subscription can contain. Usage only and each Success Package include an organization allowance. An organization add-on increases that allowance.
+
+Creating another organization requires available capacity in the subscription.
+
+## Create an organization
+
+Create an organization to separate workspaces, teams, or environments under the same subscription.
+
+<Steps>
+  <Step title="Open Organizations">
+    In the [Vapi Dashboard](https://dashboard.vapi.ai), open **Organizations**, then select **New organization**.
+  </Step>
+  <Step title="Enter the details">
+    Enter a name and admin email, and choose the subscription the organization belongs to.
+  </Step>
+  <Step title="Create">
+    Select **Create organization**.
+  </Step>
+</Steps>
+
+If no capacity remains, purchase an organization add-on or upgrade your Success Package before creating another organization. See [Buy capacity add-ons](/billing/manage-packages-and-add-ons#buy-capacity-add-ons).
+
+## Switch organizations
+
+Switch the active organization to work with its assistants, billing information, and settings.
+
+<Steps>
+  <Step title="Open the organization switcher">
+    In the [Vapi Dashboard](https://dashboard.vapi.ai), select the current organization name to open the organization switcher.
+  </Step>
+  <Step title="Select an organization">
+    Search for or select the organization you want. The Dashboard switches to that organization's context.
+  </Step>
+</Steps>
+
+## Shared entitlements
+
+Some entitlements apply across the subscription instead of to each organization separately. For example, concurrent call lines are shared by all organizations in the subscription.
+
+Other entitlements can apply to each organization. Check the Success Package summary or your Premier agreement to confirm how a specific entitlement is measured.
+
+## Delete an organization
+
+<Warning>
+Deleting an organization permanently removes its contents. Confirm that you no longer need its assistants, phone numbers, files, and other resources before deleting it.
+</Warning>
+
+Delete an organization you no longer need, for example to free an organization slot before reducing capacity.
+
+<Steps>
+  <Step title="Open the organization">
+    In **Organizations** or **Org settings**, open the organization's menu and select **Delete organization from subscription**.
+  </Step>
+  <Step title="Confirm the organization">
+    Type the organization name to confirm.
+  </Step>
+  <Step title="Delete">
+    Select **Delete** to remove the organization permanently.
+  </Step>
+</Steps>
+
+## Reduce capacity or downgrade
+
+Reducing organization capacity does not remove organizations automatically. Delete enough organizations before reducing capacity below the number in use.
+
+A Success Package downgrade can also reduce organization capacity and shared entitlements. Resolve any capacity conflict before confirming the downgrade. See [Downgrade or remove a Success Package](/billing/manage-packages-and-add-ons#downgrade-or-remove-a-success-package).
+
+## Premier subscriptions
+
+Premier organization capacity and related entitlements depend on the customer agreement. Contact your account team to change custom limits.
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Pricing and Success Packages" icon="fa-light fa-tags" href="/billing/pricing-and-success-packages">
+    Compare Usage only, Core, Pro, and Premier.
+  </Card>
+  <Card title="Manage Success Packages and add-ons" icon="fa-light fa-box" href="/billing/manage-packages-and-add-ons">
+    Change your Success Package and buy capacity or compliance add-ons.
+  </Card>
+</CardGroup>