From 02cbbd0f9ef74519c8535deb03542dc4bb470330 Mon Sep 17 00:00:00 2001
From: Ankur Datta <64993082+ankur-arch@users.noreply.github.com>
Date: Tue, 21 Apr 2026 15:39:45 +0200
Subject: [PATCH] feat: add steps to rotate creds for ppg integration

---
 .../content/docs/guides/postgres/vercel.mdx   | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/apps/docs/content/docs/guides/postgres/vercel.mdx b/apps/docs/content/docs/guides/postgres/vercel.mdx
index 33503281a8..91e83ab80c 100644
--- a/apps/docs/content/docs/guides/postgres/vercel.mdx
+++ b/apps/docs/content/docs/guides/postgres/vercel.mdx
@@ -92,3 +92,29 @@ To ensure the generated Prisma Client library is available on your deployed Verc
   //
 }
 ```
+
+## Security
+
+### Rotating your Prisma integration secrets in Vercel
+
+In security incidents (like [this Vercel security bulletin](https://vercel.com/kb/bulletin/vercel-april-2026-security-incident)) or as a regular security practice, you may need to rotate your Prisma integration secrets. This process generates new authentication credentials for your database connection while keeping your data intact.
+
+Follow these steps to rotate your Prisma integration secrets in Vercel:
+
+1. Open your browser and go to your specific project (e.g., `https://vercel.com/your-team-name/your-project-name`)
+2. Click **"Integrations"** in the left sidebar menu to see all connected marketplace apps
+3. Click **"Prisma"** to open the Prisma integration management page
+4. Under **"Installed Products"**, click on the specific database whose secrets you want to rotate
+5. Click the **"Settings"** tab and scroll down to find the security section
+6. Click the **"Rotate Secrets"** button to open the rotation dialog
+7. Configure rotation settings:
+   - **Delay period**: Enter `0` for immediate rotation (urgent incidents) or any other number for delayed rotation in hours (planned maintenance)
+   - **Rotation scope**: Select which secrets to rotate (database connection secrets, API tokens, etc.)
+8. Click **"Rotate Secrets"** to confirm and wait for the success message
+9. Redeploy your applications: This is critical! After rotation completes:
+   - Immediately redeploy all applications using this database (Vercel will prompt you)
+   - Click **"Redeploy"** for each affected application
+   - Verify connections work after redeployment
+   - Monitor application logs for connection errors
+
+Reach out to our [Discord community](https://pris.ly/discord) or on [X](https://pris.ly/x) if you need assistance with this process.