chore: sync docs/release-docs-staging with develop

Author: github-actions[bot]

CLAUDE.md

@@ -2,6 +2,10 @@
 
 Open-source commerce platform. TypeScript monorepo with 30+ modular commerce packages.
 
+> When working on the API reference documentation (`www/apps/api-reference`), read [`www/apps/api-reference/CLAUDE.md`](www/apps/api-reference/CLAUDE.md) for its path structure and the OAS → public docs flow.
+
+> When working on the resources documentation (`www/apps/resources`), read [`www/apps/resources/CLAUDE.md`](www/apps/resources/CLAUDE.md) for details on references and how they're generated and built
+
 ### 1. Codebase Structure
 
 **Monorepo Organization:**

packages/core/core-flows/src/api-key/workflows/create-api-keys.ts

@@ -25,7 +25,7 @@ export type CreateApiKeysWorkflowOutput = ApiKeyDTO[]
 export const createApiKeysWorkflowId = "create-api-keys"
 /**
  * This workflow creates one or more API keys, which can be secret or publishable. It's used by the
- * [Create API Key Admin API Route](https://docs.medusajs.com/api/admin#api-keys_postapikeys).
+ * [Create API Key Admin API Route](https://docs.medusajs.com/api/admin/api-keys/create-api-key).
  *
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * create API keys within your custom flows.

packages/core/core-flows/src/api-key/workflows/delete-api-keys.ts

@@ -16,7 +16,7 @@ export type DeleteApiKeysWorkflowInput = {
 export const deleteApiKeysWorkflowId = "delete-api-keys"
 /**
  * This workflow deletes one or more secret or publishable API keys. It's used by the
- * [Delete API Key Admin API Route](https://docs.medusajs.com/api/admin#api-keys_deleteapikeysid).
+ * [Delete API Key Admin API Route](https://docs.medusajs.com/api/admin/api-keys/delete-an-api-key).
  * 
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * delete API keys within your custom flows.

packages/core/core-flows/src/api-key/workflows/link-sales-channels-to-publishable-key.ts

@@ -18,7 +18,7 @@ export const linkSalesChannelsToApiKeyWorkflowId =
   "link-sales-channels-to-api-key"
 /**
  * This workflow manages the sales channels of a publishable API key. It's used by the
- * [Manage Sales Channels API Route](https://docs.medusajs.com/api/admin#api-keys_postapikeysidsaleschannels).
+ * [Manage Sales Channels API Route](https://docs.medusajs.com/api/admin/api-keys/manage-sales-channels).
  *
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * manage the sales channels of a publishable API key within your custom flows.

packages/core/core-flows/src/api-key/workflows/revoke-api-keys.ts

@@ -34,7 +34,7 @@ export const revokeApiKeysWorkflowId = "revoke-api-keys"
  * This workflow revokes one or more API keys. If the API key is a secret, 
  * it can't be used for authentication anymore. If it's publishable, it can't be used by client applications.
  * 
- * This workflow is used by the [Revoke API Key API Route](https://docs.medusajs.com/api/admin#api-keys_postapikeysidrevoke).
+ * This workflow is used by the [Revoke API Key API Route](https://docs.medusajs.com/api/admin/api-keys/revoke-api-key).
  * 
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * revoke API keys within your custom flows.

packages/core/core-flows/src/api-key/workflows/update-api-keys.ts

@@ -32,7 +32,7 @@ export type UpdateApiKeysWorkflowOutput = ApiKeyDTO[]
 export const updateApiKeysWorkflowId = "update-api-keys"
 /**
  * This workflow updates one or more secret or publishable API keys. It's used by the
- * [Update API Key Admin API Route](https://docs.medusajs.com/api/admin#api-keys_postapikeysid).
+ * [Update API Key Admin API Route](https://docs.medusajs.com/api/admin/api-keys/update-an-api-key).
  * 
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * update API keys within your custom flows.

packages/core/core-flows/src/auth/workflows/generate-reset-password-token.ts

@@ -15,8 +15,8 @@ const RESET_PASSWORD_TOKEN_TTL_SECONDS = 15 * 60
 
 /**
  * This workflow generates a reset password token for a user. It's used by the
- * [Generate Reset Password Token for Admin](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providerresetpassword)
- * and [Generate Reset Password Token for Customer](https://docs.medusajs.com/api/store#auth_postactor_typeauth_providerresetpassword)
+ * [Generate Reset Password Token for Admin](https://docs.medusajs.com/api/admin/auth/generate-reset-password-token)
+ * and [Generate Reset Password Token for Customer](https://docs.medusajs.com/api/store/auth/generate-reset-password-token)
  * API Routes.
  *
  * The workflow emits the `auth.password_reset` event, which you can listen to in

packages/core/core-flows/src/cart/workflows/add-shipping-method-to-cart.ts

@@ -51,7 +51,7 @@ export interface AddShippingMethodToCartWorkflowInput {
 export const addShippingMethodToCartWorkflowId = "add-shipping-method-to-cart"
 /**
  * This workflow adds a shipping method to a cart. It's executed by the
- * [Add Shipping Method Store API Route](https://docs.medusajs.com/api/store#carts_postcartsidshippingmethods).
+ * [Add Shipping Method Store API Route](https://docs.medusajs.com/api/store/carts/add-shipping-method).
  *
  * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around adding a shipping method to the cart.
  *

packages/core/core-flows/src/cart/workflows/add-to-cart.ts

@@ -54,7 +54,7 @@ const variantFields = deduplicate([
 export const addToCartWorkflowId = "add-to-cart"
 /**
  * This workflow adds a product variant to a cart as a line item. It's executed by the
- * [Add Line Item Store API Route](https://docs.medusajs.com/api/store#carts_postcartsidlineitems).
+ * [Add Line Item Store API Route](https://docs.medusajs.com/api/store/carts/add-line-item).
  *
  * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around adding an item to the cart.
  * For example, you can use this workflow to add a line item to the cart with a custom price.

packages/core/core-flows/src/cart/workflows/complete-cart.ts

@@ -73,7 +73,7 @@ const TWO_MINUTES = 60 * 2
 export const completeCartWorkflowId = "complete-cart"
 /**
  * This workflow completes a cart and places an order for the customer. It's executed by the
- * [Complete Cart Store API Route](https://docs.medusajs.com/api/store#carts_postcartsidcomplete).
+ * [Complete Cart Store API Route](https://docs.medusajs.com/api/store/carts/complete-cart).
  *
  * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around completing a cart.
  * For example, in the [Subscriptions recipe](https://docs.medusajs.com/resources/recipes/subscriptions/examples/standard#create-workflow),