add deprecation notices to API reference

Author: andrewkmin

api-reference/activities/create-read-only-session.mdx

@@ -10,6 +10,10 @@ import { EndpointPath } from "/snippets/api/endpoint.mdx";
 
 <EndpointPath type="submit" path="create_read_only_session" />
 
+<Warning>
+  This activity is deprecated. Use [Login with a Stamp](/api-reference/activities/login-with-a-stamp) or [Login with OAuth](/api-reference/activities/login-with-oauth) for session creation instead.
+</Warning>
+
 <Authorizations />
 
 <H3Bordered text="Body" />

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" />

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" />

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" />

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" />

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" />

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" />

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" />