Collection Contracts — Slack
01How to read this page #sec_487f6ca2
Each resource that REVIEWIT can collect for Slack has a published contract. It is read like an API reference: what REVIEWIT calls on the collected service and by what means, what the contract requires for the collection to execute, and the data that REVIEWIT retains. REVIEWIT only performs reads.
- Calls: the requests that REVIEWIT sends to the collected service, all in read mode.
- Requirements: each must be satisfied. Its nature indicates what it demands: a right to grant to the identifier, an administration condition (a setting or assignment at the provider that the token does not carry, observed by a real read call), or the identifier's membership in the Slack workspace of the connection. The rule states how many options are needed: “required” for the single option, “one of” when one is sufficient (they are ranked from narrowest to broadest: prefer the first), “all”, or “N of M to choose from.”
- Operating conditions: what REVIEWIT checks before each collection, beyond the requirements.
- Freshness: the maximum age of the verifications on which the verdict is based, set by each contract (here: verifications less than 24 hours old; rights must be observed by a real call). REVIEWIT automatically redoes verifications it can perform within this period (token obtained, service responding); “Verify rights”, in the connection menu, redoes them on demand. As long as the real call has not been made, the rights remain unobserved.
- Data retained: the fields that REVIEWIT keeps from each object; the role indicates what the review does with it.
The verdict of each resource, for your connection, is read on its card. A resource that the connection does not collect can still be fed by importing a report (“Import a report”).
02How REVIEWIT verifies requirements #sec_b6669f0d
The Slack token does not carry its rights: the contract requires that they be observed by a real call, in read mode. REVIEWIT does not yet make this call for Slack: it observes that the token is obtained and that the service responds, but not the rights listed here. Resources are displayed as “Not verified”; they can still be fed by importing a report (“Import a report”).
03Call paths #sec_1058f591
A path indicates which token REVIEWIT obtains for the identifier: who issues it and for which audience. The addresses called are listed in the calls of each resource; a path starting with “/” is called on the token's audience of its path.
| Path | Token issued by | Token audience | Identifier authentication |
|---|---|---|---|
| slack.web-api.reviewit.app-token | https://slack.com/api/oauth.v2.access | https://slack.com/api | token or API secret |
04Conversations · Slack Connect channels #sec_6a07c744
slack.conversations.connect-channels:collect · contract revision 3, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Channels shared with an external organization (Slack Connect)
Calls
- GET conversations.list (is_ext_shared)
- GET conversations.info
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | all | channels:read and groups:read |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: verifications less than 24 hours old; rights must be observed by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| ChannelId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| ConnectedTeamIds | context, no effect on the review | text | no |
| ConnectedTeamNames | context, no effect on the review | text | no |
| IsExtShared | context, no effect on the review | boolean | no |
| IsPendingExtShared | context, no effect on the review | boolean | no |
| NumMembers | context, no effect on the review | integer | no |
05Conversations · Channel members #sec_b2cc14d6
slack.conversations.memberships:collect · contract revision 3, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Channel members: people, bots, and external members (Slack Connect). Line key: ChannelId | UserId.
Calls
- GET conversations.list?types=public_channel,private_channel
- GET conversations.members
- GET users.list (Handle, Email, IsBot, IsExternal
- profile.email with users:read.email)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | all | channels:read and groups:read |
| Right | all | users:read and users:read.email |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data stored
| Field | Role | Type | Required |
|---|---|---|---|
| MembershipKey | object key | text | yes |
| ChannelId | context, no effect on review | text | yes |
| ChannelName | context, no effect on review | text | no |
| UserId | context, no effect on review | text | yes |
| Handle | displayed to recognize the object | text | yes |
| displayed to recognize the object | text | no | |
| IsBot | context, no effect on review | boolean | no |
| IsExternal | context, no effect on review | boolean | no |
06Conversations · Private channels #sec_6fd090de
slack.conversations.private-channels:collect · contract revision 2, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Private channels visible to the application
Calls
- GET conversations.list?types=private_channel
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | groups:read |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data stored
| Field | Role | Type | Required |
|---|---|---|---|
| ChannelId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| Creator | context, no effect on review | text | no |
| Created | context, no effect on review | date and time | no |
| IsArchived | context, no effect on review | boolean | no |
| NumMembers | context, no effect on review | integer | no |
| Topic | context, no effect on review | text | no |
| Purpose | context, no effect on review | text | no |
07Conversations · Public channels #sec_ad6b215b
slack.conversations.public-channels:collect · contract revision 2, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Public channels, their creator, and their archiving status
Calls
- GET conversations.list?types=public_channel
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | channels:read |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data stored
| Field | Role | Type | Required |
|---|---|---|---|
| ChannelId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| Creator | context, no effect on review | text | no |
| Created | context, no effect on review | date and time | no |
| IsArchived | context, no effect on review | boolean | no |
| NumMembers | context, no effect on review | integer | no |
| Topic | context, no effect on review | text | no |
| Purpose | context, no effect on review | text | no |
08Directory · Guests #sec_e2730131
slack.directory.guests:collect · contract revision 3, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Single-channel guests and multi-channel guests
Calls
- GET users.list (is_restricted, is_ultra_restricted
- profile.email with users:read.email)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | all | users:read and users:read.email |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data stored
| Field | Role | Type | Required |
|---|---|---|---|
| UserId | object key | text | yes |
| Handle | displayed to recognize the object | text | yes |
| RealName | context, no effect on review | text | no |
| displayed to recognize the object | text | no | |
| GuestType | context, no effect on review | text | no |
| InvitedBy | context, no effect on review | text | no |
| ExpiresOn | context, no effect on review | date and time | no |
| Deleted | context, no effect on review | boolean | no |
09Directory · Pending invitations #sec_ea68488c
slack.directory.pending-invitations:collect · contract revision 2, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Invitation requests submitted for administrator approval, pending or approved
Methods reserved for Slack Enterprise organizations: they require an application token installed on the organization by one of its owners or administrators.
Calls
- GET admin.inviteRequests.list
- GET admin.inviteRequests.approved.list
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | admin.invites:read |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| InviteId | object key | text | yes |
| displayed to recognize the object | text | yes | |
| InvitedBy | context, no effect on review | text | no |
| InvitedOn | context, no effect on review | date and time | no |
| InviteType | context, no effect on review | text | no |
| Channels | context, no effect on review | text | no |
| Status | context, no effect on review | text | no |
10Directory · Users and bots #sec_5512c006
slack.directory.users:collect · contract revision 3, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Workspace accounts: members, bots, deactivated accounts
Calls
- GET users.list (users and bots
- profile.email with users:read.email)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | all | users:read and users:read.email |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| UserId | object key | text | yes |
| Handle | displayed to recognize the object | text | yes |
| RealName | context, no effect on review | text | no |
| displayed to recognize the object | text | no | |
| IsAdmin | context, no effect on review | boolean | no |
| IsOwner | context, no effect on review | boolean | no |
| IsBot | context, no effect on review | boolean | no |
| Deleted | context, no effect on review | boolean | no |
| Updated | context, no effect on review | date and time | no |
11Privileged roles · Administrators and custom roles #sec_26a1dabe
slack.privileged-roles.admins:collect · contract revision 3, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Owners, administrators, and custom roles. Line key: UserId | RoleType | Scope (Empty Scope for is_admin and is_owner).
Methods reserved for Slack Enterprise organizations: they require an application token installed on the organization by one of its owners or administrators.
Calls
- GET users.list (is_admin, is_owner
- profile.email with users:read.email)
- GET admin.roles.listAssignments
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | all | users:read and users:read.email |
| Right | required | admin.roles:read |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| AssignmentKey | object key | text | yes |
| UserId | context, no effect on review | text | yes |
| Handle | displayed to recognize the object | text | yes |
| RealName | context, no effect on review | text | no |
| displayed to recognize the object | text | no | |
| RoleName | displayed to recognize the object | text | no |
| RoleType | context, no effect on review | text | yes |
| Scope | context, no effect on review | text | no |
12Third-party apps · Installed apps #sec_6cfa3904
slack.apps.installed-apps:collect · contract revision 2, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Apps approved on the workspace or organization, and their scopes
Methods reserved for Slack Enterprise organizations: they require an application token installed on the organization by one of its owners or administrators.
Calls
- GET admin.apps.approved.list
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | admin.apps:read |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| AppId | object key | text | yes |
| AppName | displayed to recognize the object | text | yes |
| Publisher | context, no effect on review | text | no |
| InstalledByUserId | context, no effect on review | text | no |
| InstalledOn | context, no effect on review | date and time | no |
| Scopes | context, no effect on review | text | no |
| IsDirectoryApproved | context, no effect on review | boolean | no |
13User groups · User group members #sec_cff1c96d
slack.groups.memberships:collect · contract revision 2, published on October 18, 2026 · path slack.web-api.reviewit.app-token
Memberships in a user group. Row key: UserGroupId | UserId.
Calls
- GET usergroups.users.list
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | usergroups:read |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data stored
| Field | Role | Type | Required |
|---|---|---|---|
| MembershipKey | object key | text | yes |
| UserGroupId | context, no effect on the review | text | yes |
| UserGroupName | context, no effect on the review | text | no |
| UserId | context, no effect on the review | text | yes |
| Handle | displayed to recognize the object | text | yes |
| displayed to recognize the object | text | no |
14User groups #sec_6b350c1e
slack.groups.user-groups:collect · contract revision 2, published on October 18, 2026 · path slack.web-api.reviewit.app-token
User groups, their @ identifier and member count
Calls
- GET usergroups.list
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | usergroups:read |
| Membership | required | the identifier belongs to the Slack workspace of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://slack.com/api responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data stored
| Field | Role | Type | Required |
|---|---|---|---|
| UserGroupId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| Handle | displayed to recognize the object | text | no |
| Description | context, no effect on the review | text | no |
| DateCreate | context, no effect on the review | date and time | no |
| DateDelete | context, no effect on the review | date and time | no |
| UserCount | context, no effect on the review | integer | no |
15To go further #sec_a28ee5aa
- Understand a collection connection
- Rights reference by resource
- Read a verdict