diff --git a/docs/integrations/cloud/databricks.mdx b/docs/integrations/cloud/databricks.mdx
index 7fee3acd3..1971190de 100644
--- a/docs/integrations/cloud/databricks.mdx
+++ b/docs/integrations/cloud/databricks.mdx
@@ -7,6 +7,12 @@ Prerequisites:
- Set up and add secrets to [Infisical Cloud](https://app.infisical.com)
+
+ When integrating with Databricks, Infisical is intended to be the source of truth for the secrets in the configured Databricks scope.
+
+ Any secrets not present in Infisical will be removed from the specified scope. To prevent removal of secrets not managed by Infisical, Infisical recommends creating a designated secret scope for your integration.
+
+
Obtain a Personal Access Token in **User Settings** > **Developer** > **Access Tokens**.
diff --git a/docs/integrations/secret-syncs/databricks.mdx b/docs/integrations/secret-syncs/databricks.mdx
index 8f305ecd6..148542708 100644
--- a/docs/integrations/secret-syncs/databricks.mdx
+++ b/docs/integrations/secret-syncs/databricks.mdx
@@ -34,6 +34,8 @@ description: "Learn how to configure a Databricks Sync for Infisical."
You must create a secret scope in your Databricks workspace prior to configuration. Ensure your service principal has [Write permissions](https://docs.databricks.com/en/security/auth/access-control/index.html#secret-acls) for the specified secret scope.
+
+ Infisical recommends creating a designated Databricks secret scope for your sync to prevent removal of secrets not managed by Infisical.
5. Configure the **Sync Options** to specify how secrets should be synced, then click **Next**.
diff --git a/docs/mint.json b/docs/mint.json
index f604ff310..bf40a9778 100644
--- a/docs/mint.json
+++ b/docs/mint.json
@@ -644,8 +644,7 @@
"api-reference/endpoints/oidc-auth/attach",
"api-reference/endpoints/oidc-auth/retrieve",
"api-reference/endpoints/oidc-auth/update",
- "api-reference/endpoints/oidc-auth/revoke",
- "integrations/frameworks/terraform-cloud"
+ "api-reference/endpoints/oidc-auth/revoke"
]
},
{
diff --git a/frontend/src/components/secret-syncs/forms/SecretSyncDestinationFields/DatabricksSyncFields.tsx b/frontend/src/components/secret-syncs/forms/SecretSyncDestinationFields/DatabricksSyncFields.tsx
index c6cfff0e5..533d0d2cf 100644
--- a/frontend/src/components/secret-syncs/forms/SecretSyncDestinationFields/DatabricksSyncFields.tsx
+++ b/frontend/src/components/secret-syncs/forms/SecretSyncDestinationFields/DatabricksSyncFields.tsx
@@ -40,6 +40,8 @@ export const DatabricksSyncFields = () => {
isError={Boolean(error)}
errorText={error?.message}
label="Secret Scope"
+ tooltipClassName="max-w-md"
+ tooltipText="Infisical recommends creating a designated Databricks secret scope for your sync to prevent removal of secrets not managed by Infisical."
helperText={
{
Pro Tip
- After creating an integration, your secrets will start syncing immediately. This might
- cause an unexpected override of current secrets in Databricks with secrets from Infisical.
+ When integrating with Databricks, Infisical is intended to be the source of truth for the
+ secrets in the configured Databricks scope.
+
+
+ Any secrets not present in Infisical will be removed from the specified scope. To prevent
+ removal of secrets not managed by Infisical, Infisical recommends creating a designated
+ secret scope for your integration.