Add the REST config to the Ingress guides

docs/apis-tools/zeebe-api-rest/zeebe-api-rest-overview.md

@@ -14,13 +14,17 @@ Ensure you [authenticate](./zeebe-api-rest-authentication.md) before accessing t
 
 ## Context paths
 
-For SaaS: `https://${REGION}.zeebe.camunda.io:443/${CLUSTER_ID}/v1/`, and for Self-Managed installations: `http://localhost:8080/v1/`.
+### SaaS
 
-:::note
 Find your region and cluster id under **Connection information** in your client credentials (revealed when you click on your client under the **API** tab within your cluster).
 
-For Self-Managed, the host and port depend on your configuration. The context path mentioned here is the default for the Zeebe component.
-:::
+Example path: `https://${REGION}.zeebe.camunda.io:443/${CLUSTER_ID}/v1/`
+
+### Self-Managed
+
+The context path should match the host and path defined in your Zeebe Gateway [configuration](/self-managed/setup/guides/ingress-setup.md). The path used here is the default.
+
+Example path: `http://localhost:8080/v1/`
 
 ## API Explorer
 

docs/self-managed/setup/guides/ingress-setup.md

@@ -28,6 +28,12 @@ In this setup, a single Ingress/domain is used to access Camunda 8 web applicati
 
 ![Camunda 8 Self-Managed Architecture Diagram - Combined Ingress](../../assets/camunda-platform-8-self-managed-architecture-diagram-combined-ingress.png)
 
+:::note
+**Operate, Tasklist, Optimize, Modeler, Connectors, Console:** The Ingress path value for each Component (`global.identity.auth.<component>.redirectUrl`) should match the `contextPath` for that Component.
+
+**Zeebe:** `zeebeGateway.ingress.rest.path` should match `zeebe.contextPath`.
+:::
+
 ```yaml
 # Chart values for the Camunda 8 Helm chart in combined Ingress setup.
 
@@ -87,6 +93,11 @@ zeebeGateway:
       enabled: true
       className: nginx
       host: "zeebe.camunda.example.com"
+    rest:
+      enabled: true
+      className: nginx
+      host: "camunda.example.com"
+      path: "/zeebe"
 ```
 
 :::note Web Modeler

versioned_docs/version-8.5/apis-tools/zeebe-api-rest/zeebe-api-rest-overview.md

@@ -14,13 +14,17 @@ Ensure you [authenticate](./zeebe-api-rest-authentication.md) before accessing t
 
 ## Context paths
 
-For SaaS: `https://${REGION}.zeebe.camunda.io:443/${CLUSTER_ID}/v1/`, and for Self-Managed installations: `http://localhost:8080/v1/`.
+### SaaS
 
-:::note
 Find your region and cluster id under **Connection information** in your client credentials (revealed when you click on your client under the **API** tab within your cluster).
 
-For Self-Managed, the host and port depend on your configuration. The context path mentioned here is the default for the Zeebe component.
-:::
+Example path: `https://${REGION}.zeebe.camunda.io:443/${CLUSTER_ID}/v1/`
+
+### Self-Managed
+
+The context path should match the host and path defined in your Zeebe Gateway [configuration](/self-managed/setup/guides/ingress-setup.md). The path used here is the default.
+
+Example path: `http://localhost:8080/v1/`
 
 ## API Explorer
 

versioned_docs/version-8.5/self-managed/setup/guides/ingress-setup.md

@@ -38,6 +38,12 @@ In this setup, a single Ingress/domain is used to access Camunda 8 web applicati
 
 ![Camunda 8 Self-Managed Architecture Diagram - Combined Ingress](../../assets/camunda-platform-8-self-managed-architecture-diagram-combined-ingress.png)
 
+:::note
+**Operate, Tasklist, Optimize, Modeler, Connectors, Console:** The Ingress path value for each Component (`global.identity.auth.<component>.redirectUrl`) should match the `contextPath` for that Component.
+
+**Zeebe:** `zeebeGateway.ingress.rest.path` should match `zeebe.contextPath`.
+:::
+
 ```yaml
 # Chart values for the Camunda 8 Helm chart in combined Ingress setup.
 
@@ -99,6 +105,11 @@ zeebeGateway:
       enabled: true
       className: nginx
       host: "zeebe.camunda.example.com"
+    rest:
+      enabled: true
+      className: nginx
+      host: "camunda.example.com"
+      path: "/zeebe"
 ```
 
 :::note Web Modeler

versioned_docs/version-8.6/apis-tools/zeebe-api-rest/zeebe-api-rest-overview.md

@@ -14,13 +14,17 @@ Ensure you [authenticate](./zeebe-api-rest-authentication.md) before accessing t
 
 ## Context paths
 
-For SaaS: `https://${REGION}.zeebe.camunda.io:443/${CLUSTER_ID}/v1/`, and for Self-Managed installations: `http://localhost:8080/v1/`.
+### SaaS
 
-:::note
 Find your region and cluster id under **Connection information** in your client credentials (revealed when you click on your client under the **API** tab within your cluster).
 
-For Self-Managed, the host and port depend on your configuration. The context path mentioned here is the default for the Zeebe component.
-:::
+Example path: `https://${REGION}.zeebe.camunda.io:443/${CLUSTER_ID}/v1/`
+
+### Self-Managed
+
+The context path should match the host and path defined in your Zeebe Gateway [configuration](/self-managed/setup/guides/ingress-setup.md). The path used here is the default.
+
+Example path: `http://localhost:8080/v1/`
 
 ## API Explorer
 

versioned_docs/version-8.6/self-managed/setup/guides/ingress-setup.md

@@ -42,6 +42,12 @@ In this setup, a single Ingress/domain is used to access Camunda 8 web applicati
 
 ![Camunda 8 Self-Managed Architecture Diagram - Combined Ingress](../../assets/camunda-platform-8-self-managed-architecture-diagram-combined-ingress.png)
 
+:::note
+**Operate, Tasklist, Optimize, Modeler, Connectors, Console:** The Ingress path value for each Component (`global.identity.auth.<component>.redirectUrl`) should match the `contextPath` for that Component.
+
+**Zeebe:** `zeebeGateway.ingress.rest.path` should match `zeebe.contextPath`.
+:::
+
 ```yaml
 # Chart values for the Camunda 8 Helm chart in combined Ingress setup.
 
@@ -101,6 +107,11 @@ zeebeGateway:
       enabled: true
       className: nginx
       host: "zeebe.camunda.example.com"
+    rest:
+      enabled: true
+      className: nginx
+      host: "camunda.example.com"
+      path: "/zeebe"
 ```
 
 :::note Web Modeler