From f2517209302e365ae7a9bb6103f5da5b1c7b655f Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Tue, 17 Nov 2026 21:24:51 -0800 Subject: [PATCH 1/3] feat(web-api): add apps.managed.permissions.set method Co-Authored-By: Claude --- .changeset/apps-managed-permissions-set.md | 5 +++ packages/web-api/src/methods.ts | 14 ++++++++ packages/web-api/src/types/request/apps.ts | 9 +++++ packages/web-api/src/types/request/index.ts | 1 + .../AppsManagedPermissionsSetResponse.ts | 17 ++++++++++ packages/web-api/src/types/response/index.ts | 1 + .../web-api/test/types/methods/apps.test-d.ts | 34 +++++++++++++++++++ 7 files changed, 81 insertions(+) create mode 100644 .changeset/apps-managed-permissions-set.md create mode 100644 packages/web-api/src/types/response/AppsManagedPermissionsSetResponse.ts diff --git a/.changeset/apps-managed-permissions-set.md b/.changeset/apps-managed-permissions-set.md new file mode 100644 index 000000000..a873a8773 --- /dev/null +++ b/.changeset/apps-managed-permissions-set.md @@ -0,0 +1,5 @@ +--- +"@slack/web-api": minor +--- + +feat(web-api): add [`apps.managed.permissions.set`](https://docs.slack.dev/reference/methods/apps.managed.permissions.set) method diff --git a/packages/web-api/src/methods.ts b/packages/web-api/src/methods.ts index d146ae135..e9a874c08 100644 --- a/packages/web-api/src/methods.ts +++ b/packages/web-api/src/methods.ts @@ -119,6 +119,7 @@ import type { APITestArguments, AppsConnectionsOpenArguments, AppsEventAuthorizationsListArguments, + AppsManagedPermissionsSetArguments, AppsManifestCreateArguments, AppsManifestDeleteArguments, AppsManifestExportArguments, @@ -418,6 +419,7 @@ import type { ApiTestResponse, AppsConnectionsOpenResponse, AppsEventAuthorizationsListResponse, + AppsManagedPermissionsSetResponse, AppsManifestCreateResponse, AppsManifestDeleteResponse, AppsManifestExportResponse, @@ -1652,6 +1654,18 @@ export abstract class Methods extends EventEmitter { ), }, }, + managed: { + permissions: { + /** + * @description Set who can interact with a managed app. + * @see {@link https://docs.slack.dev/reference/methods/apps.managed.permissions.set `apps.managed.permissions.set` API reference}. + */ + set: bindApiCall( + this, + 'apps.managed.permissions.set', + ), + }, + }, manifest: { /** * @description Create an app from an app manifest. diff --git a/packages/web-api/src/types/request/apps.ts b/packages/web-api/src/types/request/apps.ts index efe24eb46..5c7499767 100644 --- a/packages/web-api/src/types/request/apps.ts +++ b/packages/web-api/src/types/request/apps.ts @@ -13,6 +13,15 @@ export interface AppsEventAuthorizationsListArguments extends TokenOverridable, event_context: string; } +// https://docs.slack.dev/reference/methods/apps.managed.permissions.set +export interface AppsManagedPermissionsSetArguments extends AppID, TokenOverridable { + /** + * @description Who can interact with the app. Use everyone to allow all members, or app_owner to restrict access to + * the app's owner. + */ + permissions: 'app_owner' | 'everyone'; +} + // https://docs.slack.dev/reference/methods/apps.manifest.create export interface AppsManifestCreateArguments extends TokenOverridable { manifest: Manifest; diff --git a/packages/web-api/src/types/request/index.ts b/packages/web-api/src/types/request/index.ts index f051ccf4b..89a9d94fe 100644 --- a/packages/web-api/src/types/request/index.ts +++ b/packages/web-api/src/types/request/index.ts @@ -144,6 +144,7 @@ export type { APITestArguments } from './api'; export type { AppsConnectionsOpenArguments, AppsEventAuthorizationsListArguments, + AppsManagedPermissionsSetArguments, AppsManifestCreateArguments, AppsManifestDeleteArguments, AppsManifestExportArguments, diff --git a/packages/web-api/src/types/response/AppsManagedPermissionsSetResponse.ts b/packages/web-api/src/types/response/AppsManagedPermissionsSetResponse.ts new file mode 100644 index 000000000..b0ce07fb5 --- /dev/null +++ b/packages/web-api/src/types/response/AppsManagedPermissionsSetResponse.ts @@ -0,0 +1,17 @@ +///////////////////////////////////////////////////////////////////////////////////////// +// // +// !!! DO NOT EDIT THIS FILE !!! // +// // +// This file is auto-generated by scripts/generate-web-api-types.sh in the repository. // +// Please refer to the script code to learn how to update the source data. // +// // +///////////////////////////////////////////////////////////////////////////////////////// + +import type { WebAPICallResult } from '../../WebClient'; +export type AppsManagedPermissionsSetResponse = WebAPICallResult & { + error?: string; + needed?: string; + ok?: boolean; + provided?: string; + warning?: string; +}; diff --git a/packages/web-api/src/types/response/index.ts b/packages/web-api/src/types/response/index.ts index 9f188ba58..d2ae129df 100644 --- a/packages/web-api/src/types/response/index.ts +++ b/packages/web-api/src/types/response/index.ts @@ -123,6 +123,7 @@ export { AgentsSessionsSetStatusResponse } from './AgentsSessionsSetStatusRespon export { ApiTestResponse } from './ApiTestResponse'; export { AppsConnectionsOpenResponse } from './AppsConnectionsOpenResponse'; export { AppsEventAuthorizationsListResponse } from './AppsEventAuthorizationsListResponse'; +export { AppsManagedPermissionsSetResponse } from './AppsManagedPermissionsSetResponse'; export { AppsManifestCreateResponse } from './AppsManifestCreateResponse'; export { AppsManifestDeleteResponse } from './AppsManifestDeleteResponse'; export { AppsManifestExportResponse } from './AppsManifestExportResponse'; diff --git a/packages/web-api/test/types/methods/apps.test-d.ts b/packages/web-api/test/types/methods/apps.test-d.ts index 58f00c35c..f304fbbb1 100644 --- a/packages/web-api/test/types/methods/apps.test-d.ts +++ b/packages/web-api/test/types/methods/apps.test-d.ts @@ -20,6 +20,40 @@ expectAssignable>([ }, ]); +// apps.managed.permissions.set +// -- sad path +expectError(web.apps.managed.permissions.set()); // lacking argument +expectError(web.apps.managed.permissions.set({})); // empty argument +expectError( + web.apps.managed.permissions.set({ + app_id: 'A1234', // missing permissions + }), +); +expectError( + web.apps.managed.permissions.set({ + permissions: 'everyone', // missing app_id + }), +); +expectError( + web.apps.managed.permissions.set({ + app_id: 'A1234', + permissions: 'no_one', // invalid permissions + }), +); +// -- happy path +expectAssignable>([ + { + app_id: 'A1234', + permissions: 'everyone', + }, +]); +expectAssignable>([ + { + app_id: 'A1234', + permissions: 'app_owner', + }, +]); + // apps.manifest.create // -- sad path expectError(web.apps.manifest.create()); // lacking argument From 3db8ec51d3829c4053e4dd2e457735f3f14bdd62 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 18 Nov 2026 12:24:30 -0800 Subject: [PATCH 2/3] feat(web-api): add the apps.managed.permissions.set response fields Co-Authored-By: Claude --- .../types/response/AppsManagedPermissionsSetResponse.ts | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/packages/web-api/src/types/response/AppsManagedPermissionsSetResponse.ts b/packages/web-api/src/types/response/AppsManagedPermissionsSetResponse.ts index b0ce07fb5..a3e32e805 100644 --- a/packages/web-api/src/types/response/AppsManagedPermissionsSetResponse.ts +++ b/packages/web-api/src/types/response/AppsManagedPermissionsSetResponse.ts @@ -9,9 +9,17 @@ import type { WebAPICallResult } from '../../WebClient'; export type AppsManagedPermissionsSetResponse = WebAPICallResult & { + channel_restriction_mode?: string; error?: string; needed?: string; ok?: boolean; + permission_type?: string; provided?: string; + response_metadata?: ResponseMetadata; + user_ids?: string[]; warning?: string; }; + +export interface ResponseMetadata { + messages?: string[]; +} From 5a92b1a541ef66084937ed89f85b3fcb67578bd6 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 18 Nov 2026 13:18:19 -0800 Subject: [PATCH 3/3] docs(web-api): wrap the apps.managed.permissions.set values in backticks Co-Authored-By: Claude Co-authored-by: Michael Brooks <21328+mwbrooks@users.noreply.github.com> --- packages/web-api/src/types/request/apps.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/web-api/src/types/request/apps.ts b/packages/web-api/src/types/request/apps.ts index 8871535ba..de7252003 100644 --- a/packages/web-api/src/types/request/apps.ts +++ b/packages/web-api/src/types/request/apps.ts @@ -24,8 +24,8 @@ export interface AppsIconSetArguments extends AppID, TokenOverridable { // https://docs.slack.dev/reference/methods/apps.managed.permissions.set export interface AppsManagedPermissionsSetArguments extends AppID, TokenOverridable { /** - * @description Who can interact with the app. Use everyone to allow all members, or app_owner to restrict access to - * the app's owner. + * @description Who can interact with the app. Use `everyone` to allow all members, or `app_owner` to restrict access + * to the app's owner. */ permissions: 'app_owner' | 'everyone'; }