Add channel_ids restrictions to admin.apps.permissions methods

- Added channel_ids argument to admin.apps.permissions.add/remove/set for channel-level restrictions
- Added channel_restriction_mode argument and two new errors to admin.apps.permissions.set
- Removed is_embedded_preview_enabled argument from admin.apps.config.set
- Added response examples for channel restriction scenarios
- Expanded chunks description in chat.startStream/chat.stopStream to list supported chunk types

Author: Slack API Ref Buildbot

docs.slack.dev/methods/admin.apps.config.set.json

@@ -65,10 +65,6 @@
             }
           }
         }
-      },
-      "is_embedded_preview_enabled": {
-        "type": "boolean",
-        "desc": "Whether the app is allowed to render embedded previews of its work objects on this team. Only settable for apps that have declared embed domains, as the setting does not apply to any other app, and only where the embedded preview feature is available to the caller."
       }
     }
   },

docs.slack.dev/methods/admin.apps.permissions.add.json

@@ -43,6 +43,15 @@
         "items": {
           "schema": "subteam_id"
         }
+      },
+      "channel_ids": {
+        "type": "array",
+        "desc": "List of encoded channel IDs to add to the channel restriction list. Interpretation depends on the app's `channel_restriction_mode`, which is configured via the `admin.apps.permissions.set` method.",
+        "example": "C00000001,C00000002",
+        "items": {
+          "schema": "channel_id"
+        },
+        "maxItems": 200
       }
     }
   },

docs.slack.dev/methods/admin.apps.permissions.remove.json

@@ -43,6 +43,15 @@
         "items": {
           "schema": "subteam_id"
         }
+      },
+      "channel_ids": {
+        "type": "array",
+        "desc": "List of encoded channel IDs to remove from the channel restriction list. Interpretation depends on the app's `channel_restriction_mode`, which is configured via the `admin.apps.permissions.set` method.",
+        "example": "C00000001,C00000002",
+        "items": {
+          "schema": "channel_id"
+        },
+        "maxItems": 200
       }
     }
   },
@@ -93,5 +102,18 @@
       "desc": "User does not have permission to perform this action."
     }
   },
-  "examples": {}
+  "examples": {
+    "channel_restrictions": {
+      "url": "/api/admin.apps.permissions.remove",
+      "description": "When the app has channel restrictions configured, the response reflects the updated channel list",
+      "example": {
+        "ok": true,
+        "permission_type": "everyone",
+        "channel_restriction_mode": "specific_channels",
+        "channel_ids": [
+          "C00000001"
+        ]
+      }
+    }
+  }
 }

docs.slack.dev/methods/admin.apps.permissions.set.json

@@ -53,6 +53,24 @@
         "items": {
           "schema": "subteam_id"
         }
+      },
+      "channel_restriction_mode": {
+        "desc": "The mode that defines where the app can be used in channels",
+        "type": "string",
+        "enum": [
+          "all_channels",
+          "specific_channels",
+          "all_channels_except"
+        ]
+      },
+      "channel_ids": {
+        "type": "array",
+        "desc": "List of encoded channel IDs for channel restrictions. Semantics depend on channel_restriction_mode: allowlist for specific_channels, exclusion list for all_channels_except",
+        "example": "C00000001,C00000002",
+        "items": {
+          "schema": "channel_id"
+        },
+        "maxItems": 200
       }
     }
   },
@@ -101,7 +119,27 @@
     },
     "restricted_action": {
       "desc": "User does not have permission to perform this action."
+    },
+    "channel_restrictions_not_available": {
+      "desc": "Channel restrictions are not available for this workspace."
+    },
+    "channel_restriction_requires_app_access": {
+      "desc": "Channel access cannot be configured while the app is set to no_one, since the app can't be used in any channel."
     }
   },
-  "examples": {}
+  "examples": {
+    "channel_restrictions": {
+      "url": "/api/admin.apps.permissions.set",
+      "description": "When channel restrictions are configured, the response also includes `channel_restriction_mode` and, for `specific_channels` or `all_channels_except`, the `channel_ids` it applies to. When `permission_type` is `no_one`, the response returns `channel_restriction_mode` as `no_one`, since the app can't be used in any channel.",
+      "example": {
+        "ok": true,
+        "permission_type": "everyone",
+        "channel_restriction_mode": "specific_channels",
+        "channel_ids": [
+          "C00000001",
+          "C00000002"
+        ]
+      }
+    }
+  }
 }

docs.slack.dev/methods/chat.startStream.json

@@ -31,7 +31,7 @@
         "subtype": "channel"
       },
       "chunks": {
-        "desc": "Array of streaming chunks.",
+        "desc": "Array of streaming chunks. Can include [markdown text chunk](#markdown_text-chunks) objects, [task update chunk](#task_update-chunks) objects, [plan update chunks](#plan_update-chunks), or [blocks chunks](#blocks-chunks).",
         "type": "array"
       },
       "markdown_text": {

docs.slack.dev/methods/chat.stopStream.json

@@ -32,7 +32,7 @@
         "subtype": "channel"
       },
       "chunks": {
-        "desc": "Array of streaming chunks.",
+        "desc": "Array of streaming chunks. Can include [markdown text chunk](#markdown_text-chunks) objects, [task update chunk](#task_update-chunks) objects, [plan update chunks](#plan_update-chunks), or [blocks chunks](#blocks-chunks).",
         "type": "array",
         "schema": ""
       },

methods/admin/admin.apps.config.set.json

@@ -23,11 +23,6 @@
       "required": false,
       "desc": "Domain restrictions for the app. Should be an object with two properties: urls and emails. Each is an array of strings, and each sets the allowed URLs and emails for connector authorization, respectively.",
       "type": "object"
-    },
-    "is_embedded_preview_enabled": {
-      "required": false,
-      "desc": "Whether the app is allowed to render embedded previews of its work objects on this team. Only settable for apps that have declared embed domains, as the setting does not apply to any other app, and only where the embedded preview feature is available to the caller.",
-      "type": "boolean"
     }
   },
   "response": {

methods/admin/admin.apps.permissions.add.json

@@ -21,6 +21,12 @@
       "example": "S00000001,S00000002",
       "desc": "List of encoded usergroup IDs.",
       "type": "array"
+    },
+    "channel_ids": {
+      "required": false,
+      "example": "C00000001,C00000002",
+      "desc": "List of encoded channel IDs to add to the channel restriction list. Interpretation depends on the app's channel_restriction_mode, which is configured via the admin.apps.permissions.set method.",
+      "type": "array"
     }
   },
   "response": {

methods/admin/admin.apps.permissions.remove.json

@@ -21,10 +21,18 @@
       "example": "S00000001,S00000002",
       "desc": "List of encoded usergroup IDs.",
       "type": "array"
+    },
+    "channel_ids": {
+      "required": false,
+      "example": "C00000001,C00000002",
+      "desc": "List of encoded channel IDs to remove from the channel restriction list. Interpretation depends on the app's channel_restriction_mode, which is configured via the admin.apps.permissions.set method.",
+      "type": "array"
     }
   },
   "response": {
-    "examples": []
+    "examples": [
+      "{\n    \"ok\": true,\n    \"permission_type\": \"everyone\",\n    \"channel_restriction_mode\": \"specific_channels\",\n    \"channel_ids\": [\n        \"C00000001\"\n    ]\n}"
+    ]
   },
   "errors": {
     "access_denied": "This actor does not have access to the permissions on this resource.",

methods/admin/admin.apps.permissions.set.json

@@ -26,10 +26,23 @@
       "example": "S00000001,S00000002",
       "desc": "List of encoded usergroup IDs.",
       "type": "array"
+    },
+    "channel_restriction_mode": {
+      "required": false,
+      "desc": "The mode that defines where the app can be used in channels.",
+      "type": "enum"
+    },
+    "channel_ids": {
+      "required": false,
+      "example": "C00000001,C00000002",
+      "desc": "List of encoded channel IDs for channel restrictions. Semantics depend on channel_restriction_mode: allowlist for specific_channels, exclusion list for all_channels_except.",
+      "type": "array"
     }
   },
   "response": {
-    "examples": []
+    "examples": [
+      "{\n    \"ok\": true,\n    \"permission_type\": \"everyone\",\n    \"channel_restriction_mode\": \"specific_channels\",\n    \"channel_ids\": [\n        \"C00000001\",\n        \"C00000002\"\n    ]\n}"
+    ]
   },
   "errors": {
     "access_denied": "This actor does not have access to the permissions on this resource.",
@@ -38,6 +51,8 @@
     "app_not_found": "This app does not exist.",
     "channel_ids_required": "channel_ids is required when channel_restriction_mode is specific_channels or all_channels_except.",
     "channel_not_found": "One or more channel IDs are not valid.",
+    "channel_restriction_requires_app_access": "Channel access cannot be configured while the app is set to no_one, since the app can't be used in any channel.",
+    "channel_restrictions_not_available": "Channel restrictions are not available for this workspace.",
     "deprecated_endpoint": "The endpoint has been deprecated.",
     "ekm_access_denied": "Administrators have suspended the ability to post a message.",
     "enterprise_is_restricted": "The method cannot be called from an Enterprise.",