diff --git a/.changeset/gentle-flies-boil.md b/.changeset/gentle-flies-boil.md
new file mode 100644
index 000000000..d6bb1d0a9
--- /dev/null
+++ b/.changeset/gentle-flies-boil.md
@@ -0,0 +1,6 @@
+---
+"@logto/console": patch
+"@logto/core": patch
+---
+
+update documentation reference links
diff --git a/packages/console/src/pages/ApiResourceDetails/components/ManagementApiNotice/index.tsx b/packages/console/src/pages/ApiResourceDetails/components/ManagementApiNotice/index.tsx
index 5562b2214..b477f0f69 100644
--- a/packages/console/src/pages/ApiResourceDetails/components/ManagementApiNotice/index.tsx
+++ b/packages/console/src/pages/ApiResourceDetails/components/ManagementApiNotice/index.tsx
@@ -15,7 +15,7 @@ function ManagementApiNotice() {
     return null;
   }
 
-  const learnMoreLink = getDocumentationUrl('/docs/tutorials/get-started/explore-management-api');
+  const learnMoreLink = getDocumentationUrl('/docs/recipes/interact-with-management-api');
 
   return (
     <InlineNotification
diff --git a/packages/core/src/env-set/preconditions.ts b/packages/core/src/env-set/preconditions.ts
index e2df97e3d..6b9a79e8f 100644
--- a/packages/core/src/env-set/preconditions.ts
+++ b/packages/core/src/env-set/preconditions.ts
@@ -49,7 +49,7 @@ const checkAlterationState = async (pool: CommonQueryMethods) => {
       'npm run alteration deploy'
     )} command.\n\n` +
       ` See ${chalk.blue(
-        'https://docs.logto.io/docs/tutorials/using-cli/database-alteration'
+        'https://docs.logto.io/docs/references/using-cli/database-alteration'
       )} for reference.\n`
   );