From a7069a2231c939fca64fe49b684e67823b488937 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 4 Jun 2026 07:25:01 +0000
Subject: [PATCH] docs: clarify AI agent content editing requires data access

---
 guides/ai-agents/content-tools.mdx | 12 ++++++++----
 guides/ai-agents/data-access.mdx   |  4 ++++
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/guides/ai-agents/content-tools.mdx b/guides/ai-agents/content-tools.mdx
index 81f891e6..a94ef1c8 100644
--- a/guides/ai-agents/content-tools.mdx
+++ b/guides/ai-agents/content-tools.mdx
@@ -41,8 +41,9 @@ For example, ask the agent to "add this chart to the Revenue dashboard", "move t
 
 Content editing is available only when all of these are true:
 
-1. **The agent has content editing enabled.** This is a setting on each agent.
-2. **The requesting user has permission to use dashboards as code.** This is included for admins and developers.
+1. **The agent has [data access](/guides/ai-agents/data-access) enabled.** Content editing depends on data access — if you turn data access off, content editing is automatically turned off and locked.
+2. **The agent has content editing enabled.** This is a setting on each agent.
+3. **The requesting user has permission to use dashboards as code.** This is included for admins and developers.
 
 Turning the setting on does not give viewers or interactive viewers new permissions. If they ask the agent to create or edit saved content, the agent will not have those tools available.
 
@@ -57,8 +58,11 @@ Turning the setting on does not give viewers or interactive viewers new permissi
 Only admins and developers can enable content editing for an agent:
 
 1. Go to your agent settings
-2. Toggle **Allow agent to manage Lightdash content**
-3. Save your changes
+2. Make sure **Data Access** is enabled — content editing is disabled until data access is on
+3. Toggle **Allow agent to manage Lightdash content**
+4. Save your changes
+
+New agents have data access enabled by default, so content editing is available to toggle on as soon as you create the agent.
 
 ## Reviewing changes
 
diff --git a/guides/ai-agents/data-access.mdx b/guides/ai-agents/data-access.mdx
index ab5a2349..036b4924 100644
--- a/guides/ai-agents/data-access.mdx
+++ b/guides/ai-agents/data-access.mdx
@@ -28,6 +28,10 @@ AI agents offer flexible data access control to balance insights with privacy an
   structure and not see actual data values.
 </Info>
 
+<Warning>
+  [Content editing](/guides/ai-agents/content-tools) requires data access. If you turn data access off, content editing is automatically turned off and locked until you re-enable data access.
+</Warning>
+
 To change data access, go to your agent settings and toggle the "Data Access" option.
 
   <Frame>