Collection Contracts — Dropbox
01How to read this page #sec_ad073a7d
Each resource that REVIEWIT can collect for Dropbox has a published contract. It is read as 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, verified by a real read call), or the identifier's membership in the connection's Dropbox team. 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 ».
- Operational conditions: what REVIEWIT verifies 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 verified 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 is not made, the rights remain unverified.
- 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_baec0ba7
The Dropbox token does not carry its rights: the contract requires that they be verified by a real read call. REVIEWIT does not yet make this call for Dropbox: it verifies 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_aa579778
A path indicates which token REVIEWIT obtains for the identifier: who issues it and for which audience. The called addresses appear 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 |
|---|---|---|---|
| dropbox.team.reviewit.app | https://api.dropboxapi.com/oauth2/token | https://api.dropboxapi.com | token or API secret |
04Directory · Team members #sec_b383ef81
dropbox.directory.members:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Team members, their status, and their role
Calls
- POST /2/team/members/list_v2
- POST /2/team/members/list/continue_v2
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | members.read |
| Membership | required | the identifier belongs to the connection's Dropbox team |
Operational conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: verifications less than 24 hours old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| TeamMemberId | object key | text | yes |
| displayed to recognize the object | text | yes | |
| DisplayName | displayed to recognize the object | text | no |
| Status | context, no effect on the review | text | no |
| Role | context, no effect on the review | text | no |
| JoinedOn | context, no effect on the review | date and time | no |
| ExternalId | context, no effect on the review | text | no |
05Groups #sec_8e4bf902
dropbox.groups.groups:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Team groups, managed by the company or by the user
Calls
- POST /2/team/groups/list
- POST /2/team/groups/list/continue
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | groups.read |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| GroupId | object key | text | yes |
| GroupName | displayed to recognize the object | text | yes |
| ManagementType | context, no effect on the review | text | no |
| MemberCount | context, no effect on the review | integer | no |
| ExternalId | context, no effect on the review | text | no |
06Groups · Group members #sec_0f3a6cc8
dropbox.groups.memberships:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Group memberships and role (member or manager). Line key: GroupId | TeamMemberId.
Calls
- POST /2/team/groups/members/list
- POST /2/team/groups/members/list/continue
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | groups.read |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| MembershipKey | object key | text | yes |
| GroupId | context, no effect on the review | text | yes |
| GroupName | context, no effect on the review | text | no |
| TeamMemberId | context, no effect on the review | text | yes |
| displayed to recognize the object | text | yes | |
| AccessType | context, no effect on the review | text | no |
07Privileged roles · Team administrators #sec_2bf483df
dropbox.privileged-roles.admins:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Team administrators and their administration scope
Calls
- POST /2/team/members/list_v2 (roles)
- POST /2/team/members/get_available_team_member_roles
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | members.read |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| TeamMemberId | object key | text | yes |
| displayed to recognize the object | text | yes | |
| DisplayName | displayed to recognize the object | text | no |
| Role | context, no effect on the review | text | no |
| Status | context, no effect on the review | text | no |
| JoinedOn | context, no effect on the review | date and time | no |
08Shared content · Share members and invitations #sec_c6e9d19c
dropbox.sharing.memberships:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Members of a share and invitations still pending. Line key: SharedFolderId | PrincipalId (account, group or guest address).
Calls
- POST /2/sharing/list_folder_members (on behalf of each member)
- POST /2/sharing/list_folder_members/continue (on behalf of each member)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | members.read |
| Right | required | team_data.member |
| Right | required | sharing.read |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| MembershipKey | object key | text | yes |
| SharedFolderId | context, no effect on the review | text | yes |
| SharedFolderName | context, no effect on the review | text | no |
| PrincipalId | context, no effect on the review | text | yes |
| PrincipalType | context, no effect on the review | text | no |
| displayed to recognize the object | text | yes | |
| AccessType | context, no effect on the review | text | no |
| IsInherited | context, no effect on the review | boolean | no |
| InvitationPending | context, no effect on the review | boolean | no |
09Shared content · Shared folders #sec_892c126b
dropbox.sharing.shared-folders:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Shared folders, their owner, and their sharing policy
Calls
- POST /2/sharing/list_folders (on behalf of each member)
- POST /2/sharing/list_folders/continue (on behalf of each member)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Permission | required | members.read |
| Permission | required | team_data.member |
| Permission | required | sharing.read |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h old; permissions must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| SharedFolderId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| PathLower | context, no effect on review | text | no |
| OwnerTeam | context, no effect on review | text | no |
| AccessType | context, no effect on review | text | no |
| IsInsideTeamFolder | context, no effect on review | boolean | no |
| PolicyMemberPolicy | context, no effect on review | text | no |
10Shared content · Shared links #sec_ef07fa72
dropbox.sharing.shared-links:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Shared links: audience, password, expiration
Calls
- POST /2/sharing/list_shared_links (on behalf of each member)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Permission | required | members.read |
| Permission | required | team_data.member |
| Permission | required | sharing.read |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h old; permissions must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| LinkId | object key | text | yes |
| Url | displayed to recognize the object | text | yes |
| PathLower | context, no effect on review | text | no |
| Visibility | evaluated by REVIEWIT policies (visibility) | text | no |
| HasPassword | context, no effect on review | boolean | no |
| Expires | context, no effect on review | date and time | no |
| CreatedBy | access subject to review | list of identities | no |
11Team spaces · Team folder access #sec_cdb4c7fe
dropbox.team-space.memberships:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Groups and members with access to a team folder. Line key: TeamFolderId | PrincipalId.
Calls
- POST /2/team/team_folder/list
- POST /2/sharing/list_folder_members (team folders, on behalf of an administrator)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Permission | required | team_data.team_space |
| Permission | required | sharing.read |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h old; permissions must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| MembershipKey | object key | text | yes |
| TeamFolderId | context, no effect on review | text | yes |
| TeamFolderName | displayed to recognize the object | text | yes |
| PrincipalId | context, no effect on review | text | yes |
| PrincipalType | context, no effect on review | text | no |
| AccessType | context, no effect on review | text | no |
| IsInherited | context, no effect on review | boolean | no |
12Team spaces #sec_9bc60b77
dropbox.team-space.namespaces:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Team namespaces (namespaces): member folders, shared folders, team folders, and application folders
Calls
- POST /2/team/namespaces/list
- POST /2/team/namespaces/list/continue
Requirements
| Nature | Rule | Options |
|---|---|---|
| Permission | one of | team_data.member or team_data.team_space |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h old; permissions must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| NamespaceId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| NamespaceType | context, no effect on review | text | no |
| TeamMemberId | context, no effect on review | text | no |
| IsInsideTeamFolder | context, no effect on review | boolean | no |
13Team spaces · Team folders #sec_42cb5e57
dropbox.team-space.team-folders:collect · contract revision 2, published on October 18, 2026 · path dropbox.team.reviewit.app
Team folders, their status, and their synchronization
Calls
- POST /2/team/team_folder/list
- POST /2/team/team_folder/list/continue
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | one of choice | team_data.team_space ou team_data.content.read |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| TeamFolderId | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| Status | context, no effect on the review | text | no |
| IsTeamSharedDropbox | context, no effect on the review | boolean | no |
| SyncSetting | context, no effect on the review | text | no |
| ContentPolicy | context, no effect on the review | text | no |
14Third-party apps · Linked applications #sec_692fcc7b
dropbox.apps.linked-apps:collect · contract revision 3, published on October 18, 2026 · path dropbox.team.reviewit.app
Third-party applications linked to team member accounts, one row per application and per member. Row key: TeamMemberId | AppId.
Calls
- POST /2/team/linked_apps/list_members_linked_apps
- POST /2/team/members/get_info_v2 (Email)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Right | required | sessions.list |
| Right | required | members.read |
| Membership | required | the identifier belongs to the Dropbox team of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://api.dropboxapi.com responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| LinkKey | object key | text | yes |
| AppId | context, no effect on the review | text | yes |
| AppName | context, no effect on the review | text | no |
| Publisher | context, no effect on the review | text | no |
| TeamMemberId | context, no effect on the review | text | yes |
| displayed to recognize the object | text | yes | |
| LinkedOn | context, no effect on the review | date and time | no |
| IsAppFolder | context, no effect on the review | boolean | no |
15To go further #sec_feb78037
- Understanding a collection connection
- Rights reference by resource
- Reading a verdict