docs(webhooks): webhooks are in public beta

Webhooks are in public beta. The docs install them from the normal release, and the old private beta page redirects to a new public beta page.

Mono-RevId: 50414d5db406f0bdc488b25fcf001df37f809bbb

Author: ericallam

docs/docs.json

@@ -165,6 +165,7 @@
             "group": "Webhooks",
             "pages": [
               "webhooks/overview",
+              "webhooks/public-beta",
               "webhooks/sources",
               "webhooks/connect",
               "webhooks/deliveries",
@@ -804,6 +805,11 @@
     ]
   },
   "redirects": [
+    {
+      "source": "/webhooks/private-beta",
+      "destination": "/webhooks/public-beta",
+      "permanent": true
+    },
     {
       "source": "/queue-concurrency",
       "destination": "/concurrency",

docs/webhooks/private-beta.mdx

@@ -0,0 +1,70 @@
+---
+title: "Webhooks public beta"
+description: "Webhooks are available to every organization in the normal Trigger.dev release. Install the packages, see what may change before general availability, and send feedback."
+sidebarTitle: "Public beta"
+---
+
+**Webhooks are in public beta: every organization can use them, and they ship in the normal Trigger.dev release.** Endpoints you declare sync when you deploy or run `trigger dev`, and they show up on each environment's **Webhooks** page.
+
+## What public beta means
+
+- The API may still change before general availability. We announce changes in the [changelog](https://trigger.dev/changelog).
+- Webhooks are open source, so they work self-hosted too. See [Self-hosting webhooks](/self-hosting/env/webapp#webhooks) to turn them on.
+
+## Install the packages
+
+Webhooks are in `@trigger.dev/sdk` 4.8.1 and later. Install the SDK and the CLI from `@latest`:
+
+<CodeGroup>
+
+```bash npm
+npm i @trigger.dev/sdk@latest
+npm i -D trigger.dev@latest
+```
+
+```bash pnpm
+pnpm add @trigger.dev/sdk@latest
+pnpm add -D trigger.dev@latest
+```
+
+```bash bun
+bun add @trigger.dev/sdk@latest
+bun add -D trigger.dev@latest
+```
+
+</CodeGroup>
+
+Add the connector packages if you're building Slack or Linear agents:
+
+<CodeGroup>
+
+```bash npm
+npm i @trigger.dev/slack@latest @trigger.dev/linear@latest
+```
+
+```bash pnpm
+pnpm add @trigger.dev/slack@latest @trigger.dev/linear@latest
+```
+
+```bash bun
+bun add @trigger.dev/slack@latest @trigger.dev/linear@latest
+```
+
+</CodeGroup>
+
+The webhook tools in the [MCP server](/mcp-introduction) come with the CLI, so a current `trigger.dev` install has them.
+
+## Moving from a private beta build
+
+If you installed from the `webhooks` npm tag, switch every Trigger.dev package to `@latest`, including `@trigger.dev/build` if your project has it. Versions like `4.8.0-webhooks.20261020092920` are older than 4.8.1. You can also remove any minimum release age exemption you added for the beta builds, and reinstall the MCP server without `--tag webhooks`.
+
+## Get started
+
+- [Overview](/webhooks/overview): endpoints, sources, and what can subscribe.
+- [Connect a provider](/webhooks/connect): register the URL and signing secret, then check that events arrive.
+- [Slack agents](/webhooks/slack) and [Linear agents](/webhooks/linear): turn a `chat.agent` into an agent that lives in Slack or Linear.
+- [Deliveries and endpoints](/webhooks/deliveries): inspect payloads, replay deliveries, and see the runs each one started.
+
+## Feedback
+
+Send bugs, questions and ideas to [eric@trigger.dev](mailto:eric@trigger.dev). Delivery ids (`whd_...`) and run ids help us find what happened.