Docs updates for Connect (#17148)

* Not ready to merge

* Connect pricing

* Fixing links

* Minor cleanup

* Update index.mdx

Author: dannyroosevelt

docs-v2/pages/_meta.tsx

@@ -1,9 +1,27 @@
 export default {
-  "index": "What is Pipedream?",
+  "index": "Introduction",
   "workspaces": "Workspaces",
   "projects": "Projects",
-  "connect": "Connect",
-  "workflows": "Workflows",
+  "--connect": {
+    type: "separator",
+    title: "Connect",
+  },
+  "connect": {
+    title: "Integrate APIs",
+    // display: "children",
+  },
+  "--workflows": {
+    type: "separator",
+    title: "Workflows",
+  },
+  "workflows": {
+    title: "Build Workflows",
+    // display: "children",
+  },
+  "--platform": {
+    type: "separator",
+    title: "Platform",
+  },
   "apps": "Apps",
   "components": "Components",
   "rest-api": "REST API",

docs-v2/pages/account/billing-settings.mdx

@@ -6,38 +6,40 @@ You'll find information on your usage data (for specific [Pipedream limits](/wor
 
 ## Subscription
 
-You can upgrade to [paid plans](https://pipedream.com/pricing) from this section.
-
 If you've already upgraded, you'll see an option to **Manage Subscription** here, which directs you to your personal Stripe portal. Here, you can change your payment method, review the details of previous invoices, and more.
 
 ## Usage
 
-[Credits](/pricing/#credits) are Pipedream's billable unit, and users on the [free tier](/pricing/#free-tier) are limited on the number of daily free credits allocated. The **Usage** section displays a chart of the daily credits across a historical range of time to provide insight into your usage patterns.
+[Credits](/pricing/#credits-and-billing) are Pipedream's billable unit, and users on the [free plan](/pricing/#free-plan) are limited on the number of daily free credits allocated. The **Usage** section displays a chart of the daily credits across a historical range of time to provide insight into your usage patterns.
+
+<Callout type="warning">
+Credit usage from [Connect](/connect) is not yet reflected in this section.
+</Callout>
 
 Hover over a specific column in the chart to see the number of credits run for that specific day:
 
 ![Daily credits tooltip](/images/account/daily-invocations-tooltip.png)
 
-_Click_ on a specific column to see credits for that day, broken out by workflow / source:
+Click on a specific column to see credits for that day, broken out by workflow / source:
 
 ![Credits broken out by workflow / source](/images/account/usage-by-resource.png)
 
 Users on the free tier will see the last 30 days of usage in this chart. Users on [paid plans](https://pipedream.com/pricing) will see the cumulative usage tied to their current billing period.
 
 ## Compute Budget
 
-Control the maximum number of compute credits permitted on your account with an _Credit Budget_.
+Control the maximum number of credits permitted on your account with a **Credit Budget**.
 
-This will restrict your account-wide usage to the specified number of [credits](/pricing/#credits) on a monthly or daily basis. The compute budget does not apply to credits incurred by [dedicated workers](/workflows/building-workflows/settings/#eliminate-cold-starts).
+This will restrict your workspace-wide usage to the specified number of [credits](/pricing/#credits-and-billing) on a monthly or daily basis. The compute budget does not apply to credits incurred by [dedicated workers](/workflows/building-workflows/settings/#eliminate-cold-starts) or Pipedream Connect.
 
-To enable this feature, _click_ on the toggle and define your maximum number of credits in the period.
+To enable this feature, click on the toggle and define your maximum number of credits in the period.
 
 <Callout type="info">
-Due to how credits are accrued, there may be cases where your credit usage may _slightly_ go over the cap.
+Due to how credits are accrued, there may be cases where your credit usage may go slightly over the cap.
 
 In an example scenario, with a cap set at 20 credits and a long-running workflow that uses 10 credits per run, it's possible that two concurrent events trigger the workflow, and the cap won't apply until after the concurrent events are processed.
 </Callout>
 
 ## Limits
 
-For users on the [Free tier](/pricing/#free-tier), this section displays your usage towards your [credits quota](/workflows/limits/#daily-credits-limit) for the current UTC day.
+For users on the [Free tier](/pricing/#free-plan), this section displays your usage towards your [credits quota](/workflows/limits/#daily-credits-limit) for the current UTC day.

docs-v2/pages/connect/_meta.tsx

@@ -1,5 +1,5 @@
 export default {
-  "index": "Overview",
+  "index": "Pipedream Connect",
   "use-cases": "Use Cases",
   "managed-auth": "Managed Auth",
   "components": "Tool Use",

docs-v2/pages/connect/api-proxy.mdx

@@ -79,7 +79,7 @@ import { createBackendClient } from "@pipedream/sdk/server";
 
 const pd = createBackendClient({
   environment: {development | production},
-  projectId: {your_pipedream_project_i_d},
+  projectId: {your_pipedream_project_id},
   credentials: {
     clientId: {your_oauth_client_id},
     clientSecret: {your_oauth_client_secret}

docs-v2/pages/connect/api.mdx

@@ -235,10 +235,6 @@ curl -X POST "https://api.pipedream.com/v1/connect/{your_project_id}/actions/run
 
 ## API Reference
 
-### Invoke workflows
-
-You can use the SDK to [invoke workflows on behalf of any end user](/connect/workflows/). **Write one workflow, run it for all of your users**.
-
 ### Tokens
 
 Your app will initiate the account connection flow for your end users in your frontend. To securely scope connection to a specific end user, on your server, **you retrieve a short-lived token for that user**, and return that token to your frontend.
@@ -3726,3 +3722,9 @@ curl -X PUT \
   ]
 }
 ```
+
+### Workflows
+
+#### Invoke workflows
+
+You can use the SDK to [invoke workflows on behalf of any end user](/connect/workflows/). **Write one workflow, run it for all of your users**.

docs-v2/pages/connect/mcp/openai.mdx

@@ -101,7 +101,6 @@ const pd = createBackendClient({
 // For this example, we'll use Notion
 const apps = await pd.getApps({ q: "notion" });
 const appSlug = apps.data[0].name_slug; // e.g., "notion",
-const appLabel = apps.data[0].name; // e.g., "Notion"
 
 // Get access token for MCP server auth
 const accessToken = await pd.rawAccessToken();
@@ -118,7 +117,7 @@ const response = await client.responses.create({
   tools: [
     {
       type: 'mcp',
-      server_label: appLabel,
+      server_label: appSlug,
       server_url: `https://remote.mcp.pipedream.net`,
       headers: {
         Authorization: `Bearer ${accessToken}`,

docs-v2/pages/glossary.mdx

@@ -104,7 +104,7 @@ You can restrict access to connected accounts to specific individuals or share w
 
 ### Credit
 
-Pipedream charges one credit per 30 seconds of compute time at 256MB megabytes of memory (the default) per workflow execution. Credits are also charged for [dedicated workers](#dedicated-workers). [See the docs](/pricing/#credits) for more details.
+Pipedream charges one credit per 30 seconds of compute time at 256MB megabytes of memory (the default) per workflow execution. Credits are also charged for [dedicated workers](#dedicated-workers). [See the docs](/pricing/#credits-and-billing) for more details.
 
 ### Custom domain
 

docs-v2/pages/index.mdx

@@ -2,13 +2,16 @@ import VideoPlayer from "@/components/VideoPlayer";
 
 # Introduction to Pipedream
 
-Pipedream is the fastest way to automate any process that connects APIs. Build and run workflows with code-level control when you need it, and no code when you don't. Easily add thousands of customer-facing integrations to your app or AI agent in minutes.
+Pipedream is the easiest way to automate any process that connects APIs:
+
+- [Pipedream Connect](/connect) makes it easy to add thousands of customer-facing integrations to your app or AI agent in minutes
+- Our [visual builder](/workflows) lets you build and run complex workflows with code-level control when you need it, and no code when you don't
 
 The Pipedream platform includes:
 
 - A [serverless runtime](/workflows/building-workflows/code/) and [workflow service](/workflows/building-workflows/)
-- SDK to handle [customer authentication](/connect/) for {process.env.PUBLIC_APPS}+ APIs
-- Source-available pre-built [triggers](/workflows/building-workflows/triggers/) and [actions](/workflows/building-workflows/actions/) for [thousands of integrated apps](https://pipedream.com/explore/)
+- SDKs to handle [user authentication](/connect/) for {process.env.PUBLIC_APPS}+ APIs
+- Source-available [triggers](/workflows/building-workflows/triggers/) and [actions](/workflows/building-workflows/actions/) for [thousands of integrated apps](https://pipedream.com/explore/)
 - One-click [OAuth and key-based authentication](/apps/connected-accounts/) for more than {process.env.PUBLIC_APPS} APIs (use tokens directly in code or with pre-built actions)
 
 <VideoPlayer
@@ -18,32 +21,23 @@ The Pipedream platform includes:
 
 ## Getting Started
 
-To get started, [sign up for a free account](https://pipedream.com/auth/signup) (no credit card required) and follow our [quickstart guide](/quickstart/) to create your first workflow.
-
-![build, test,deploy](https://res.cloudinary.com/pipedreamin/image/upload/v1672810771/mjckfcgsoxs4vccutdbj.png)
-
-Once you understand the basics of workflow development, learn how to get more out of Pipedream:
-
-- [Use code in workflows](/workflows/building-workflows/code/)
-- [Develop custom actions](/components/contributing/actions-quickstart/)
-- [Develop custom triggers](/components/contributing/quickstart/nodejs/sources/)
+To get started, [sign up for a free account](https://pipedream.com/auth/signup) (no credit card required) and follow our [quickstart guide](/quickstart/) to create your first workflow or add your first integration.
 
 ## Use Cases
 
-Pipedream supports use cases from prototype to production and is trusted by 800k+ developers from startups to Fortune 500 companies:
+Pipedream supports use cases from prototype to production and is trusted by more than 1 million developers from startups to Fortune 500 companies:
 
 ![logos](https://res.cloudinary.com/pipedreamin/image/upload/v1612919944/homepage/logos_kcbviz.png)
 
-The platform processes billions of events and is built and [priced](https://pipedream.com/pricing/) for use at scale. [Our team](https://pipedream.com/about) has built internet scale applications and managed data pipelines in excess of 10 million events per second (EPS) at startups and high-growth environments like BrightRoll, Yahoo!, Affirm and Instacart.
+The platform processes billions of events and is built and [priced](https://pipedream.com/pricing/) for use at scale. [Our team](https://pipedream.com/about) has built internet scale applications and managed data pipelines in excess of 10 million events per second (EPS) at startups and high-growth environments like BrightRoll, Yahoo!, Affirm, and Dropbox.
 
-Our [community](https://pipedream.com/community) uses Pipedream for a wide variety of use cases including:
+Our [community](https://pipedream.com/support) uses Pipedream for a wide variety of use cases including:
 
-- Connecting SaaS apps
-- General API orchestration and automation
-- Database automations ([learn about connecting to resources behind a firewall](/workflows/data-management/databases/))
+- AI agents and chatbots
+- Workflow builders and SaaS automation
+- API orchestration and automation
+- Database automations
 - Custom notifications and alerting
-- Mobile and JAMstack backends
-- Rate limiting, request smoothing
 - Event queueing and concurrency management
 - Webhook inspection and routing
 - Prototyping and demos