Sample - Slack Web API
POST/admin.teams.settings.setDiscoverability

Set workspace discoverability

Sets the discoverability setting for a specified workspace. Supply team_id and choose the workspace's new discoverability value. The value must be open, invite_only, closed, or unlisted.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 2 body fields
tokenstringrequired
Authentication token with the `admin.teams:write` scope.

Workspace discoverability setting data.

team_idstringrequired
The ID of the workspace to set discoverability on.
discoverabilitystringrequired
This workspace's discovery setting. It must be set to one of `open`, `invite_only`, `closed`, or `unlisted`.

2 status codes
200Returns a successful response with `ok` set to true.
okbooleanrequired
Allowed:true
defaultReturns the standard failure response with `ok` set to false.
okbooleanrequired
Allowed:false

Error handling

team_id and discoverability must both be provided in the request body. discoverability must be one of open, invite_only, closed, or unlisted, and token must carry the admin.teams:write scope.