Merge pull request #12489 from hashicorp/docs/results-filtered-by-acl-awareness-coordinate

docs: mention filtered by ACLs in coordinate API

website/content/api-docs/coordinate.mdx

@@ -78,6 +78,8 @@ within the same area.
 This endpoint returns the LAN network coordinates for all nodes in a given
 datacenter.
 
+@include 'http_api_results_filtered_by_acls.mdx'
+
 | Method | Path                | Produces           |
 | ------ | ------------------- | ------------------ |
 | `GET`  | `/coordinate/nodes` | `application/json` |

website/content/api-docs/index.mdx

@@ -110,6 +110,27 @@ of results, because some have been filtered out by ACL policies.
 In order to limit information leakage, this header is only present for requests
 authenticated by a valid ACL token.
 
+The following example uses `curl` to view the
+`X-Consul-Results-Filtered-By-ACLs` response header.
+
+```shell-session
+$ curl \
+    --header "X-Consul-Token: <non-anonymous consul token>" \
+    --include \
+    http://127.0.0.1:8500/v1/catalog/services
+
+HTTP/1.1 200 OK
+Content-Type: application/json
+...
+X-Consul-Default-Acl-Policy: deny
+X-Consul-Results-Filtered-By-Acls: true
+
+{
+  "redis": [],
+  "postgresql": ["primary", "secondary"]
+}
+```
+
 ## UUID Format
 
 UUID-format identifiers generated by the Consul API use the

website/content/partials/http_api_results_filtered_by_acls.mdx

@@ -0,0 +1,3 @@
+The HTTP response includes the `X-Consul-Results-Filtered-By-ACLs: true` header
+if the response array excludes results due to ACL policy configuration.
+Refer to the [HTTP API documentation](/api-docs#results-filtered-by-acls) for more information.