diff --git a/detect/synthetic-monitoring/api-checks/configuration.mdx b/detect/synthetic-monitoring/api-checks/configuration.mdx
index 6977306c..b9cfd963 100644
--- a/detect/synthetic-monitoring/api-checks/configuration.mdx
+++ b/detect/synthetic-monitoring/api-checks/configuration.mdx
@@ -20,7 +20,7 @@ Start by specifying the endpoint you want to track.
 - **IP family**: Defaults to IPv4.
 - **Skip SSL**: Skip SSL certificate validation.
 - **Follow redirects**: Automatically follow 30x redirects.
-- **This request should fail**: Treat HTTP error codes (4xx and 5xx) as passed. Please note that successful responses still pass. Only failed assertions will cause the check to fail.
+- **This request should fail**: Treat HTTP error codes (4xx and 5xx) as passed. Please note that successful responses still pass. Only failed assertions will cause the check to fail. In [Monitoring as Code](/concepts/monitoring-as-code), this maps to the [`shouldFail`](/constructs/api-check) boolean property on the `ApiCheck` construct.
 
 ## Body
 
diff --git a/detect/uptime-monitoring/url-monitors/configuration.mdx b/detect/uptime-monitoring/url-monitors/configuration.mdx
index f5909aad..7c95a64a 100644
--- a/detect/uptime-monitoring/url-monitors/configuration.mdx
+++ b/detect/uptime-monitoring/url-monitors/configuration.mdx
@@ -18,7 +18,7 @@ Monitor public URLs by specifying the endpoint you want to track.
 * **IP family:** Choose between IPv4 (default) or IPv6
 * **Follow redirects:** Automatically follow 30x redirects
 * **Skip SSL:** Skip SSL certificate validation
-* **This request should fail:** Treat HTTP error codes (4xx and 5xx) as passed. Please note that successful responses still pass. Only failed assertions will cause the check to fail
+* **This request should fail:** Treat HTTP error codes (4xx and 5xx) as passed. Please note that successful responses still pass. Only failed assertions will cause the check to fail. In [Monitoring as Code](/concepts/monitoring-as-code), this maps to the [`shouldFail`](/constructs/url-monitor) boolean property on the `UrlMonitor` construct.
 
 ### Assertions