Skip to main content

slackLists.access.set method

Usage info​

Lists are only available to Slack workspaces on a paid plan.

This method is used to set the access level to a List for specified entities (users or channels). Call this API method to establish and set the desired access level for the List.

Both channel_ids and user_ids cannot be passed at the same time, but at least one of them is required.

The possible access_level values are as follows:

  • read: grants read access to the List.
  • write: grants read and write access to the List.
  • owner: makes the specified user in user_ids the owner. If channel_ids is provided with this access level, the API method will return an invalid_arguments error because only users can be owners. Only the current file owner can set another user as the owner. Upgrades to the owner level for users from a different team than the one the List belongs to is not allowed.

Sample requests data​

Grant channel read access​

{
  "token": "***",
  "list_id": "F1234567",
  "access_level": "read",
  "channel_ids": ["C7654321"]
}

Grant user read access​

{
  "token": "***",
  "list_id": "F1234567",
  "access_level": "read",
  "user_ids": ["U012A34BCDE"]
}

Response​