From d698900039dbd31518bdf6b1fb9a27522cfab35a Mon Sep 17 00:00:00 2001
From: Andrew Min <andrew@turnkey.io>
Date: Wed, 21 Jan 2026 17:01:38 -0500
Subject: [PATCH] add deprecation notices to API reference

---
 api-reference/activities/create-read-write-session.mdx | 4 ++++
 api-reference/activities/init-email-recovery.mdx       | 4 ++++
 api-reference/activities/init-otp-auth.mdx             | 4 ++++
 api-reference/activities/oauth.mdx                     | 4 ++++
 api-reference/activities/otp-auth.mdx                  | 4 ++++
 api-reference/activities/perform-email-auth.mdx        | 4 ++++
 api-reference/activities/update-user.mdx               | 4 ++++
 7 files changed, 28 insertions(+)

diff --git a/api-reference/activities/create-read-write-session.mdx b/api-reference/activities/create-read-write-session.mdx
index d8f7c262..17f88850 100644
--- a/api-reference/activities/create-read-write-session.mdx
+++ b/api-reference/activities/create-read-write-session.mdx
@@ -10,6 +10,10 @@ import { EndpointPath } from "/snippets/api/endpoint.mdx";
 
 <EndpointPath type="submit" path="create_read_write_session" />
 
+<Warning>
+  This activity is deprecated. Use [Login with a Stamp](/api-reference/activities/login-with-a-stamp), [Login with OAuth](/api-reference/activities/login-with-oauth), or [Login with OTP](/api-reference/activities/login-with-otp) for session creation instead.
+</Warning>
+
 <Authorizations />
 
 <H3Bordered text="Body" />
diff --git a/api-reference/activities/init-email-recovery.mdx b/api-reference/activities/init-email-recovery.mdx
index 215c7a61..198daba1 100644
--- a/api-reference/activities/init-email-recovery.mdx
+++ b/api-reference/activities/init-email-recovery.mdx
@@ -10,6 +10,10 @@ import { EndpointPath } from "/snippets/api/endpoint.mdx";
 
 <EndpointPath type="submit" path="init_user_email_recovery" />
 
+<Warning>
+  This activity is deprecated. Use [Init Generic OTP](/api-reference/activities/init-generic-otp) to initiate a recovery flow combined with [Recover a User](/api-reference/activities/recover-a-user) instead.
+</Warning>
+
 <Authorizations />
 
 <H3Bordered text="Body" />
diff --git a/api-reference/activities/init-otp-auth.mdx b/api-reference/activities/init-otp-auth.mdx
index 26661c34..48dd132f 100644
--- a/api-reference/activities/init-otp-auth.mdx
+++ b/api-reference/activities/init-otp-auth.mdx
@@ -10,6 +10,10 @@ import { EndpointPath } from "/snippets/api/endpoint.mdx";
 
 <EndpointPath type="submit" path="init_otp_auth" />
 
+<Warning>
+  This activity is deprecated. Use [Init Generic OTP](/api-reference/activities/init-generic-otp) instead.
+</Warning>
+
 <Authorizations />
 
 <H3Bordered text="Body" />
diff --git a/api-reference/activities/oauth.mdx b/api-reference/activities/oauth.mdx
index 57b46daa..66b1c28b 100644
--- a/api-reference/activities/oauth.mdx
+++ b/api-reference/activities/oauth.mdx
@@ -10,6 +10,10 @@ import { EndpointPath } from "/snippets/api/endpoint.mdx";
 
 <EndpointPath type="submit" path="oauth" />
 
+<Warning>
+  This activity is deprecated. Use [Login with OAuth](/api-reference/activities/login-with-oauth) instead.
+</Warning>
+
 <Authorizations />
 
 <H3Bordered text="Body" />
diff --git a/api-reference/activities/otp-auth.mdx b/api-reference/activities/otp-auth.mdx
index 66c431e4..91324a12 100644
--- a/api-reference/activities/otp-auth.mdx
+++ b/api-reference/activities/otp-auth.mdx
@@ -10,6 +10,10 @@ import { EndpointPath } from "/snippets/api/endpoint.mdx";
 
 <EndpointPath type="submit" path="otp_auth" />
 
+<Warning>
+  This activity is deprecated. Use [Login with OTP](/api-reference/activities/login-with-otp) instead.
+</Warning>
+
 <Authorizations />
 
 <H3Bordered text="Body" />
diff --git a/api-reference/activities/perform-email-auth.mdx b/api-reference/activities/perform-email-auth.mdx
index 22454e25..37c75bc6 100644
--- a/api-reference/activities/perform-email-auth.mdx
+++ b/api-reference/activities/perform-email-auth.mdx
@@ -10,6 +10,10 @@ import { EndpointPath } from "/snippets/api/endpoint.mdx";
 
 <EndpointPath type="submit" path="email_auth" />
 
+<Warning>
+  This activity is deprecated. Use [Init Generic OTP](/api-reference/activities/init-generic-otp) followed by [Login with OTP](/api-reference/activities/login-with-otp) instead.
+</Warning>
+
 <Authorizations />
 
 <H3Bordered text="Body" />
diff --git a/api-reference/activities/update-user.mdx b/api-reference/activities/update-user.mdx
index c3caff8f..af5f909e 100644
--- a/api-reference/activities/update-user.mdx
+++ b/api-reference/activities/update-user.mdx
@@ -10,6 +10,10 @@ import { EndpointPath } from "/snippets/api/endpoint.mdx";
 
 <EndpointPath type="submit" path="update_user" />
 
+<Warning>
+  This activity is deprecated. Use the specific update activities instead: [Update User's Email](/api-reference/activities/update-users-email), [Update User's Name](/api-reference/activities/update-users-name), or [Update User's Phone Number](/api-reference/activities/update-users-phone-number).
+</Warning>
+
 <Authorizations />
 
 <H3Bordered text="Body" />