diff --git a/packages/plugins/swr/src/generator.ts b/packages/plugins/swr/src/generator.ts
index bdea20e83..6c4e6ce5b 100644
--- a/packages/plugins/swr/src/generator.ts
+++ b/packages/plugins/swr/src/generator.ts
@@ -93,6 +93,7 @@ function generateModelHooks(
                   'const { endpoint, fetch } = useHooksContext();',
                   `const invalidate = request.useInvalidation('${model.name}', metadata);`,
               ],
+              docs: ['@deprecated Use mutation hooks (useCreateXXX, useUpdateXXX, etc.) instead.'],
           })
         : undefined;