v1.8.10

Author: joeyorlando

docs/sources/manage/notify/slack/index.md

@@ -122,6 +122,8 @@ This set of permissions is supporting the ability of Grafana OnCall to match use
   (deprecated) slack commands.
 - **Create and manage user groups** — the permission is used to automatically update user groups linked to on-call
   schedules. It will add users once their on-call shift starts and remove them once the on-call shift ends.
+  - **NOTE**: per [Slack's documentation](https://slack.com/help/articles/212906697-Create-a-user-group), you must have
+  a paid plan for this feature to work properly
 - **Set presence for Grafana OnCall**
 
 ## Post-install configuration for Slack integration

docs/sources/oncall-api-reference/alertgroups.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/alertgroups/
 title: Alert groups HTTP API
 weight: 400
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Alert groups HTTP API
@@ -48,6 +54,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 These available filter parameters should be provided as `GET` arguments:
 
 - `id`

docs/sources/oncall-api-reference/alerts.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/alerts/
 title: Alerts HTTP API
 weight: 100
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Alerts HTTP API
@@ -105,6 +111,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 The following available filter parameters should be provided as `GET` arguments:
 
 - `id`

docs/sources/oncall-api-reference/escalation_chains.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/escalation_chains/
 title: Escalation chains HTTP API
 weight: 200
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Escalation chains HTTP API
@@ -89,6 +95,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 **HTTP request**
 
 `GET {{API_URL}}/api/v1/escalation_chains/`

docs/sources/oncall-api-reference/escalation_policies.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/escalation_policies/
 title: Escalation policies HTTP API
 weight: 300
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Escalation policies HTTP API
@@ -144,6 +150,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 The following available filter parameter should be provided as a `GET` argument:
 
 - `escalation_chain_id`

docs/sources/oncall-api-reference/integrations.md

@@ -8,6 +8,11 @@ refs:
       destination: /docs/oncall/<ONCALL_VERSION>/configure/integrations/references/alertmanager/
     - pattern: /docs/grafana-cloud/
       destination: /docs/grafana-cloud/alerting-and-irm/oncall/configure/integrations/references/alertmanager/
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Integrations HTTP API
@@ -233,6 +238,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 **HTTP request**
 
 `GET {{API_URL}}/api/v1/integrations/`

docs/sources/oncall-api-reference/on_call_shifts.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/on_call_shifts/
 title: OnCall shifts HTTP API
 weight: 600
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # OnCall shifts HTTP API
@@ -150,6 +156,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 The following available filter parameters should be provided as `GET` arguments:
 
 - `name` (Exact match)

docs/sources/oncall-api-reference/outgoing_webhooks.md

@@ -13,6 +13,11 @@ refs:
       destination: /docs/oncall/<ONCALL_VERSION>/configure/integrations/outgoing-webhooks/#event-types
     - pattern: /docs/grafana-cloud/
       destination: /docs/grafana-cloud/alerting-and-irm/oncall/configure/integrations/outgoing-webhooks/#event-types
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Outgoing webhooks
@@ -66,6 +71,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 ## Get webhook
 
 ```shell
@@ -244,3 +251,5 @@ The above command returns JSON structured in the following way:
   "total_pages": 1
 }
 ```
+
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.

docs/sources/oncall-api-reference/personal_notification_rules.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/personal_notification_rules/
 title: Personal notification rules HTTP API
 weight: 800
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Personal notification rules HTTP API
@@ -122,6 +128,8 @@ The above command returns JSON structured in the following ways:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 The following available filter parameters should be provided as `GET` arguments:
 
 - `user_id`

docs/sources/oncall-api-reference/resolution_notes.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/resolution_notes/
 title: Resolution notes HTTP API
 weight: 900
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Resolution notes HTTP API
@@ -99,6 +105,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 The following available filter parameter should be provided as a `GET` argument:
 
 - `alert_group_id`

docs/sources/oncall-api-reference/routes.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/routes/
 title: Routes HTTP API
 weight: 1100
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Routes HTTP API
@@ -134,6 +140,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 The following available filter parameters should be provided as `GET` arguments:
 
 - `integration_id`

docs/sources/oncall-api-reference/schedules.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/schedules/
 title: Schedules HTTP API
 weight: 1200
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Schedules HTTP API
@@ -139,6 +145,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 The following available filter parameter should be provided as a `GET` argument:
 
 - `name` (Exact match)
@@ -307,6 +315,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 ### Caveats
 
 Some notes on the `start_date` and `end_date` query parameters:

docs/sources/oncall-api-reference/shift_swaps.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/shift_swaps/
 title: Shift swap requests HTTP API
 weight: 1200
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Shift swap requests HTTP API
@@ -185,6 +191,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 The following available filter parameters may be provided as a `GET` arguments:
 
 - `starting_after` (an ISO 8601 timestamp string, filter requests starting after the specified datetime)

docs/sources/oncall-api-reference/slack_channels.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/slack_channels/
 title: Slack channels HTTP API
 weight: 1300
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Slack channels HTTP API
@@ -34,6 +40,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 The following available filter parameter should be provided as a `GET` argument:
 
 - `channel_name`

docs/sources/oncall-api-reference/user_groups.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/user_groups/
 title: OnCall user groups HTTP API
 weight: 1400
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 <!--Used in escalation policies with type = `notify_user_group` and in schedules.-->
@@ -41,6 +47,8 @@ The above command returns JSON structured in the following way:
 }
 ```
 
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
+
 | Parameter | Unique | Description                                                                                           |
 | --------- | :----: | :---------------------------------------------------------------------------------------------------- |
 | `id`      |  Yes   | User Group ID                                                                                         |

docs/sources/oncall-api-reference/users.md

@@ -2,6 +2,12 @@
 canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/users/
 title: Grafana OnCall users HTTP API
 weight: 1500
+refs:
+  pagination:
+    - pattern: /docs/oncall/
+      destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
+    - pattern: /docs/grafana-cloud/
+      destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
 ---
 
 # Grafana OnCall users HTTP API
@@ -90,7 +96,7 @@ The above command returns JSON structured in the following way:
 }
 ```
 
-This endpoint retrieves all users.
+> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
 
 The following available filter parameter should be provided as a `GET` argument:
 

engine/apps/api/views/features.py

@@ -15,6 +15,7 @@
 class Feature(enum.StrEnum):
     MSTEAMS = "msteams"
     SLACK = "slack"
+    UNIFIED_SLACK = "unified_slack"
     TELEGRAM = "telegram"
     LIVE_SETTINGS = "live_settings"
     GRAFANA_CLOUD_NOTIFICATIONS = "grafana_cloud_notifications"
@@ -46,6 +47,9 @@ def _get_enabled_features(self, request):
         if settings.FEATURE_SLACK_INTEGRATION_ENABLED:
             enabled_features.append(Feature.SLACK)
 
+        if settings.UNIFIED_SLACK_APP_ENABLED:
+            enabled_features.append(Feature.UNIFIED_SLACK)
+
         if settings.FEATURE_TELEGRAM_INTEGRATION_ENABLED:
             enabled_features.append(Feature.TELEGRAM)