add docs

Author: KSDaemon

docs/pages/product/apis-integrations/rest-api/reference.mdx

@@ -279,6 +279,7 @@ Trigger pre-aggregation build jobs or retrieve statuses of such jobs.
 | `selector.datasources`     | Array of data source names which have pre-aggregations defined | ❌       |
 | `selector.cubes`           | Array of cube names which contain pre-aggregations             | ❌       |
 | `selector.preAggregations` | Array of pre-aggregation names                                 | ❌       |
+| `selector.dateRange`       | Date Range tuple ['range-date-start', 'range-date-end']        | ❌       |
 
 To trigger pre-aggregation builds, send a `POST` request with a payload
 including `post` as the `action` and `selector` properties. The response will
@@ -340,6 +341,27 @@ curl \
   https://localhost:4000/cubejs-api/v1/pre-aggregations/jobs
 ```
 
+Example request triggering builds of the `main` pre-aggregation defined in the
+`orders` cube within date range with some security context data
+and an `America/Los_Angeles` timezone:
+
+```bash{outputLines: 2-13}
+curl \
+  -d '{
+    "action": "post",
+    "selector": {
+      "contexts": [{ "securityContext": { "tenantId": "tenant1" } }],
+      "timezones": ["America/Los_Angeles"],
+      "preAggregations": ["orders.main"],
+      "dateRange": ["2020-01-01", "2020-02-01"]
+    }
+  }' \
+  -H "Authorization: EXAMPLE-API-TOKEN" \
+  -H "Content-Type: application/json" \
+  -X POST \
+  https://localhost:4000/cubejs-api/v1/pre-aggregations/jobs
+```
+
 Example response:
 
 ```json