Updated from Slack docs, 2025/09/08

Slack API Ref Buildbot · Slack API Ref Buildbot · commit 0e98f2edff34 · 2025-09-08T22:30:48.000Z
diff --git a/docs.slack.dev/methods/admin.apps.activities.list.json b/docs.slack.dev/methods/admin.apps.activities.list.json
@@ -1,10 +1,7 @@
 {
   "desc": "Get logs for a specified team/org",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.app_activities:read"
-  },
+  "scope": "admin.app_activities:read",
   "json_input_supported": false,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t3",
diff --git a/docs.slack.dev/methods/admin.apps.config.lookup.json b/docs.slack.dev/methods/admin.apps.config.lookup.json
@@ -1,10 +1,7 @@
 {
   "desc": "Look up the app config for connectors by their IDs",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.apps:read"
-  },
+  "scope": "admin.apps:read",
   "json_input_supported": true,
   "rate_limits": "t2",
   "args": {
diff --git a/docs.slack.dev/methods/admin.apps.config.set.json b/docs.slack.dev/methods/admin.apps.config.set.json
@@ -1,10 +1,7 @@
 {
   "desc": "Set the app config for a connector",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.apps:write"
-  },
+  "scope": "admin.apps:write",
   "json_input_supported": true,
   "rate_limits": "t3",
   "args": {
diff --git a/docs.slack.dev/methods/admin.conversations.search.json b/docs.slack.dev/methods/admin.conversations.search.json
@@ -88,7 +88,7 @@
       "conversations": {
         "type": "array",
         "items": {
-          "refs": "../../common/schemas/common_objects_schema.json#/channel"
+          "schema": "channel"
         }
       },
       "next_cursor": {
diff --git a/docs.slack.dev/methods/admin.functions.list.json b/docs.slack.dev/methods/admin.functions.list.json
@@ -1,10 +1,7 @@
 {
   "desc": "Look up functions by a set of apps",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.workflows:read"
-  },
+  "scope": "admin.workflows:read",
   "json_input_supported": true,
   "rate_limits": "t2",
   "args": {
diff --git a/docs.slack.dev/methods/admin.functions.permissions.lookup.json b/docs.slack.dev/methods/admin.functions.permissions.lookup.json
@@ -1,10 +1,7 @@
 {
   "desc": "Lookup the visibility of multiple Slack functions and include the users if it is limited to particular named entities.",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.workflows:read"
-  },
+  "scope": "admin.workflows:read",
   "json_input_supported": true,
   "rate_limits": "t3",
   "args": {
diff --git a/docs.slack.dev/methods/admin.functions.permissions.set.json b/docs.slack.dev/methods/admin.functions.permissions.set.json
@@ -1,10 +1,7 @@
 {
   "desc": "Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.workflows:write"
-  },
+  "scope": "admin.workflows:read",
   "json_input_supported": true,
   "rate_limits": "t3",
   "args": {
diff --git a/docs.slack.dev/methods/admin.workflows.collaborators.add.json b/docs.slack.dev/methods/admin.workflows.collaborators.add.json
@@ -1,10 +1,7 @@
 {
   "desc": "Add collaborators to workflows within the team or enterprise",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.workflows:write"
-  },
+  "scope": "admin.workflows:write",
   "json_input_supported": true,
   "rate_limits": "t2",
   "args": {
diff --git a/docs.slack.dev/methods/admin.workflows.collaborators.remove.json b/docs.slack.dev/methods/admin.workflows.collaborators.remove.json
@@ -1,10 +1,7 @@
 {
   "desc": "Remove collaborators from workflows within the team or enterprise",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.workflows:write"
-  },
+  "scope": "admin.workflows:write",
   "json_input_supported": true,
   "rate_limits": "t2",
   "args": {
diff --git a/docs.slack.dev/methods/admin.workflows.permissions.lookup.json b/docs.slack.dev/methods/admin.workflows.permissions.lookup.json
@@ -1,10 +1,7 @@
 {
   "desc": "Look up the permissions for a set of workflows",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.workflows:read"
-  },
+  "scope": "admin.workflows:read",
   "json_input_supported": true,
   "rate_limits": "t2",
   "args": {
diff --git a/docs.slack.dev/methods/admin.workflows.search.json b/docs.slack.dev/methods/admin.workflows.search.json
@@ -1,10 +1,7 @@
 {
   "desc": "Search workflows within the team or enterprise",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.workflows:read"
-  },
+  "scope": "admin.workflows:read",
   "json_input_supported": true,
   "rate_limits": "t2",
   "args": {
diff --git a/docs.slack.dev/methods/admin.workflows.unpublish.json b/docs.slack.dev/methods/admin.workflows.unpublish.json
@@ -1,10 +1,7 @@
 {
   "desc": "Unpublish workflows within the team or enterprise",
   "http_method": "POST",
-  "scope": "read",
-  "scope_by_token_type": {
-    "oauth": "admin.workflows:write"
-  },
+  "scope": "admin.workflows:write",
   "json_input_supported": true,
   "rate_limits": "t2",
   "args": {
diff --git a/docs.slack.dev/methods/bookmarks.add.json b/docs.slack.dev/methods/bookmarks.add.json
@@ -2,10 +2,6 @@
   "desc": "Add bookmark to a channel.",
   "http_method": "POST",
   "scope": "bookmarks:write",
-  "scope_by_token_type": {
-    "app": "bookmarks:write",
-    "granular_bot": "bookmarks:write"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t2",
diff --git a/docs.slack.dev/methods/bookmarks.edit.json b/docs.slack.dev/methods/bookmarks.edit.json
@@ -2,10 +2,6 @@
   "desc": "Edit bookmark.",
   "http_method": "POST",
   "scope": "bookmarks:write",
-  "scope_by_token_type": {
-    "app": "bookmarks:write",
-    "granular_bot": "bookmarks:write"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t2",
diff --git a/docs.slack.dev/methods/bookmarks.list.json b/docs.slack.dev/methods/bookmarks.list.json
@@ -2,10 +2,6 @@
   "desc": "List bookmark for the channel.",
   "http_method": "POST",
   "scope": "bookmarks:read",
-  "scope_by_token_type": {
-    "app": "bookmarks:read",
-    "granular_bot": "bookmarks:read"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t3",
diff --git a/docs.slack.dev/methods/bookmarks.remove.json b/docs.slack.dev/methods/bookmarks.remove.json
@@ -2,10 +2,6 @@
   "desc": "Remove bookmark from the channel.",
   "http_method": "POST",
   "scope": "bookmarks:write",
-  "scope_by_token_type": {
-    "app": "bookmarks:write",
-    "granular_bot": "bookmarks:write"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t2",
diff --git a/docs.slack.dev/methods/chat.delete.json b/docs.slack.dev/methods/chat.delete.json
@@ -2,9 +2,6 @@
   "desc": "Deletes a message.",
   "http_method": "POST",
   "scope": "chat:write",
-  "scope_by_token_type": {
-    "app": "chat:write"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t3",
diff --git a/docs.slack.dev/methods/chat.postEphemeral.json b/docs.slack.dev/methods/chat.postEphemeral.json
@@ -2,9 +2,6 @@
   "desc": "Sends an ephemeral message to a user in a channel.",
   "http_method": "POST",
   "scope": "chat:write",
-  "scope_by_token_type": {
-    "app": "chat:write"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t4",
diff --git a/docs.slack.dev/methods/chat.postMessage.json b/docs.slack.dev/methods/chat.postMessage.json
@@ -2,9 +2,6 @@
   "desc": "Sends a message to a channel.",
   "http_method": "POST",
   "scope": "chat:write",
-  "scope_by_token_type": {
-    "app": "chat:write"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t5",
diff --git a/docs.slack.dev/methods/chat.update.json b/docs.slack.dev/methods/chat.update.json
@@ -2,9 +2,6 @@
   "desc": "Updates a message.",
   "http_method": "POST",
   "scope": "chat:write",
-  "scope_by_token_type": {
-    "app": "chat:write"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t3",
diff --git a/docs.slack.dev/methods/conversations.acceptSharedInvite.json b/docs.slack.dev/methods/conversations.acceptSharedInvite.json
@@ -1,11 +1,8 @@
 {
   "desc": "Accepts an invitation to a Slack Connect channel.",
   "http_method": "POST",
-  "scope": "post",
+  "scope": "conversations.connect:write",
   "json_input_supported": true,
-  "scope_by_token_type": {
-    "granular_bot": "conversations.connect:write"
-  },
   "rate_limits": "t2",
   "args": {
     "type": "object",
diff --git a/docs.slack.dev/methods/conversations.approveSharedInvite.json b/docs.slack.dev/methods/conversations.approveSharedInvite.json
@@ -1,10 +1,7 @@
 {
   "desc": "Approves an invitation to a Slack Connect channel",
   "http_method": "POST",
-  "scope": "post",
-  "scope_by_token_type": {
-    "granular_bot": "conversations.connect:manage"
-  },
+  "scope": "conversations.connect:manage",
   "rate_limits": "t3",
   "json_input_supported": true,
   "args": {
diff --git a/docs.slack.dev/methods/conversations.archive.json b/docs.slack.dev/methods/conversations.archive.json
@@ -2,9 +2,6 @@
   "desc": "Archives a conversation.",
   "http_method": "POST",
   "scope": "conversations:write",
-  "scope_by_token_type": {
-    "app": "conversations:write"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t2",
diff --git a/docs.slack.dev/methods/conversations.create.json b/docs.slack.dev/methods/conversations.create.json
@@ -2,9 +2,6 @@
   "desc": "Initiates a public or private channel-based conversation",
   "http_method": "POST",
   "scope": "conversations:write",
-  "scope_by_token_type": {
-    "app": "conversations:write"
-  },
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t2",
diff --git a/docs.slack.dev/methods/conversations.declineSharedInvite.json b/docs.slack.dev/methods/conversations.declineSharedInvite.json
@@ -1,10 +1,7 @@
 {
   "desc": "Declines a Slack Connect channel invite.",
   "http_method": "GET",
-  "scope": "post",
-  "scope_by_token_type": {
-    "granular_bot": "conversations.connect:manage"
-  },
+  "scope": "conversations.connect:manage",
   "json_input_supported": true,
   "rate_limits": "t3",
   "args": {
diff --git a/docs.slack.dev/methods/conversations.externalInvitePermissions.set.json b/docs.slack.dev/methods/conversations.externalInvitePermissions.set.json
@@ -1,10 +1,7 @@
 {
   "desc": "Upgrade or downgrade Slack Connect channel permissions between 'can post only' and 'can post and invite'.",
   "http_method": "POST",
-  "scope": "conversations:write",
-  "scope_by_token_type": {
-    "granular_bot": "conversations.connect:manage"
-  },
+  "scope": "conversations.connect:manage",
   "rate_limits": "t2",
   "args": {
     "type": "object",
diff --git a/docs.slack.dev/methods/conversations.history.json b/docs.slack.dev/methods/conversations.history.json
@@ -2,9 +2,6 @@
   "desc": "Fetches a conversation's history of messages and events.",
   "http_method": "GET",
   "scope": "conversations:history",
-  "scope_by_token_type": {
-    "app": "conversations:history"
-  },
   "slack_connect_workspaces_allowed": true,
   "json_input_supported": true,
   "rate_limits": "t3",
diff --git a/docs.slack.dev/methods/conversations.info.json b/docs.slack.dev/methods/conversations.info.json
@@ -2,9 +2,6 @@
   "desc": "Retrieve information about a conversation.",
   "http_method": "GET",
   "scope": "conversations:read",
-  "scope_by_token_type": {
-    "app": "conversations:read"
-  },
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t3",
   "args": {
diff --git a/docs.slack.dev/methods/conversations.invite.json b/docs.slack.dev/methods/conversations.invite.json
@@ -1,12 +1,7 @@
 {
   "desc": "Invites users to a channel.",
   "http_method": "POST",
-  "scope": "conversations:write",
-  "scope_by_token_type": {
-    "oauth": "conversations:write.invites",
-    "granular_bot": "conversations:write.invites",
-    "workflow": "conversations:write.invites"
-  },
+  "scope": "conversations:write.invites",
   "json_input_supported": true,
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t3",
diff --git a/docs.slack.dev/methods/conversations.inviteShared.json b/docs.slack.dev/methods/conversations.inviteShared.json
@@ -1,10 +1,7 @@
 {
   "desc": "Sends an invitation to a Slack Connect channel",
   "http_method": "GET",
-  "scope": "post",
-  "scope_by_token_type": {
-    "granular_bot": "conversations.connect:write"
-  },
+  "scope": "conversations.connect:write",
   "rate_limits": "t2",
   "json_input_supported": true,
   "args": {
diff --git a/docs.slack.dev/methods/conversations.list.json b/docs.slack.dev/methods/conversations.list.json
@@ -2,9 +2,6 @@
   "desc": "Lists all channels in a Slack team.",
   "http_method": "GET",
   "scope": "conversations:read",
-  "scope_by_token_type": {
-    "app": "conversations:read"
-  },
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t2",
   "args": {
diff --git a/docs.slack.dev/methods/conversations.members.json b/docs.slack.dev/methods/conversations.members.json
@@ -2,9 +2,6 @@
   "desc": "Retrieve members of a conversation.",
   "http_method": "GET",
   "scope": "conversations:read",
-  "scope_by_token_type": {
-    "app": "conversations:read"
-  },
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t4",
   "args": {
diff --git a/docs.slack.dev/methods/conversations.rename.json b/docs.slack.dev/methods/conversations.rename.json
@@ -2,9 +2,6 @@
   "desc": "Renames a conversation.",
   "http_method": "POST",
   "scope": "conversations:write",
-  "scope_by_token_type": {
-    "app": "conversations:write"
-  },
   "slack_connect_workspaces_allowed": true,
   "json_input_supported": true,
   "rate_limits": "t2",
diff --git a/docs.slack.dev/methods/conversations.replies.json b/docs.slack.dev/methods/conversations.replies.json
@@ -2,9 +2,6 @@
   "desc": "Retrieve a thread of messages posted to a conversation",
   "http_method": "GET",
   "scope": "conversations:history",
-  "scope_by_token_type": {
-    "app": "conversations:history"
-  },
   "slack_connect_workspaces_allowed": true,
   "rate_limits": "t3",
   "args": {
diff --git a/docs.slack.dev/methods/conversations.requestSharedInvite.approve.json b/docs.slack.dev/methods/conversations.requestSharedInvite.approve.json
@@ -1,10 +1,7 @@
 {
   "desc": "Approves a request to add an external user to a channel and sends them a Slack Connect invite",
   "http_method": "POST",
-  "scope": "post",
-  "scope_by_token_type": {
-    "granular_bot": "conversations.connect:manage"
-  },
+  "scope": "conversations.connect:manage",
   "rate_limits": "t2",
   "json_input_supported": true,
   "args": {
diff --git a/docs.slack.dev/methods/conversations.requestSharedInvite.deny.json b/docs.slack.dev/methods/conversations.requestSharedInvite.deny.json
diff --git a/docs.slack.dev/methods/conversations.requestSharedInvite.list.json b/docs.slack.dev/methods/conversations.requestSharedInvite.list.json
diff --git a/docs.slack.dev/methods/conversations.setPurpose.json b/docs.slack.dev/methods/conversations.setPurpose.json
diff --git a/docs.slack.dev/methods/conversations.setTopic.json b/docs.slack.dev/methods/conversations.setTopic.json
diff --git a/docs.slack.dev/methods/conversations.unarchive.json b/docs.slack.dev/methods/conversations.unarchive.json
diff --git a/docs.slack.dev/methods/files.comments.delete.json b/docs.slack.dev/methods/files.comments.delete.json
diff --git a/docs.slack.dev/methods/files.completeUploadExternal.json b/docs.slack.dev/methods/files.completeUploadExternal.json
diff --git a/docs.slack.dev/methods/files.delete.json b/docs.slack.dev/methods/files.delete.json
diff --git a/docs.slack.dev/methods/files.getUploadURLExternal.json b/docs.slack.dev/methods/files.getUploadURLExternal.json
diff --git a/docs.slack.dev/methods/files.revokePublicURL.json b/docs.slack.dev/methods/files.revokePublicURL.json
diff --git a/docs.slack.dev/methods/files.sharedPublicURL.json b/docs.slack.dev/methods/files.sharedPublicURL.json
diff --git a/docs.slack.dev/methods/openid.connect.userInfo.json b/docs.slack.dev/methods/openid.connect.userInfo.json
diff --git a/docs.slack.dev/methods/team.externalTeams.disconnect.json b/docs.slack.dev/methods/team.externalTeams.disconnect.json
diff --git a/docs.slack.dev/methods/users.identity.json b/docs.slack.dev/methods/users.identity.json

Original file line number	Diff line number	Diff line change
`@@ -88,7 +88,7 @@`
`88`	`88`	`"conversations": {`
`89`	`89`	`"type": "array",`
`90`	`90`	`"items": {`
`91`		`- "refs": "../../common/schemas/common_objects_schema.json#/channel"`
	`91`	`+ "schema": "channel"`
`92`	`92`	`}`
`93`	`93`	`},`
`94`	`94`	`"next_cursor": {`