The Team > Groups API from Dropbox — 12 operation(s) for team > groups.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/dropbox-team-groups-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Dropbox API Reference Team > Groups API
description: The powerful, yet simple, Dropbox API allows you to manage and control content and team settings programmatically and extend Dropbox capabilities in new and powerful ways.
version: 1.0.0
servers:
- url: https://api.dropbox.com
security:
- bearerAuth: []
tags:
- name: Team > Groups
paths:
/2/team/groups/create:
post:
tags:
- Team > Groups
summary: Dropbox groups/create
description: 'groups/create
scope: `groups.write`
Creates a new, empty group, with a requested name.
Permission : Team member management.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"group_name\": \"Europe sales\", \n \"add_creator_as_owner\": false, \n \"group_external_id\": \"group-134\"\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
group_name: project launch
group_id: g:e2db7665347abcd600000000001a2b3c
group_management_type:
.tag: user_managed
created: 1447255518000
member_count: 5
members:
- profile:
team_member_id: dbmid:1234567
email: mary@lamb.com
email_verified: true
status:
.tag: active
name:
given_name: Franz
surname: Ferdinand
familiar_name: Franz
display_name: Franz Ferdinand (Personal)
abbreviated_name: FF
membership_type:
.tag: full
account_id: dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc
secondary_emails:
- email: apple@orange.com
is_verified: true
- email: banana@honeydew.com
is_verified: true
- email: grape@strawberry.com
is_verified: false
joined_on: '2015-05-12T15:50:38Z'
profile_photo_url: https://dl-web.dropbox.com/account_photo/get/dbaphid%3AAAHWGmIXV3sUuOmBfTz0wPsiqHUpBWvv3ZA?vers=1556069330102&size=128x128
access_type:
.tag: member
operationId: post2TeamGroupsCreate
x-operation-id-source: derived
/2/team/groups/delete:
post:
tags:
- Team > Groups
summary: Dropbox groups/delete
description: 'groups/delete
scope: `groups.write`
Deletes a group.
The group is deleted immediately. However the revoking of group-owned resources may take additional time. Use the `groups/job_status/get` to determine whether this process has completed.
Permission : Team member management.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \".tag\": \"group_id\", \n \"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
.tag: complete
operationId: post2TeamGroupsDelete
x-operation-id-source: derived
/2/team/groups/get_info:
post:
tags:
- Team > Groups
summary: Dropbox groups/get_info
description: 'groups/get_info
scope: `groups.read`
Retrieves information about one or more groups. Note that the optional field `GroupFullInfo.members` is not returned for system-managed groups.
Permission : Team Information.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \".tag\": \"group_ids\", \n \"group_ids\": [\n \"g:e2db7665347abcd600000000001a2b3c\", \n \"g:111111147abcd6000000000222222c\"\n ]\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
- .tag: group_info
group_name: project launch
group_id: g:e2db7665347abcd600000000001a2b3c
group_management_type:
.tag: user_managed
created: 1447255518000
member_count: 5
members:
- profile:
team_member_id: dbmid:1234567
email: mary@lamb.com
email_verified: true
status:
.tag: active
name:
given_name: Franz
surname: Ferdinand
familiar_name: Franz
display_name: Franz Ferdinand (Personal)
abbreviated_name: FF
membership_type:
.tag: full
account_id: dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc
secondary_emails:
- email: apple@orange.com
is_verified: true
- email: banana@honeydew.com
is_verified: true
- email: grape@strawberry.com
is_verified: false
joined_on: '2015-05-12T15:50:38Z'
profile_photo_url: https://dl-web.dropbox.com/account_photo/get/dbaphid%3AAAHWGmIXV3sUuOmBfTz0wPsiqHUpBWvv3ZA?vers=1556069330102&size=128x128
access_type:
.tag: member
operationId: post2TeamGroupsGetInfo
x-operation-id-source: derived
/2/team/groups/job_status/get:
post:
tags:
- Team > Groups
summary: Dropbox groups/job_status/get
description: 'groups/job_status/get
scope: `groups.write`
Once an async_job_id is returned from `groups/delete`, `groups/members/add` , or `groups/members/remove` use this method to poll the status of granting/revoking group members'' access to group-owned resources.
Permission : Team member management.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"async_job_id\": \"34g93hh34h04y384084\"\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
.tag: complete
operationId: post2TeamGroupsJobStatusGet
x-operation-id-source: derived
/2/team/groups/list:
post:
tags:
- Team > Groups
summary: Dropbox groups/list
description: 'groups/list
scope: `groups.read`
Lists groups on a team.
Permission : Team Information.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"limit\": 100\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
groups:
- group_name: Test group
group_id: g:e2db7665347abcd600000000001a2b3c
group_management_type:
.tag: user_managed
member_count: 10
cursor: ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu
has_more: false
operationId: post2TeamGroupsList
x-operation-id-source: derived
/2/team/groups/list/continue:
post:
tags:
- Team > Groups
summary: Dropbox groups/list/continue
description: 'groups/list/continue
scope: `groups.read`
Once a cursor has been retrieved from `groups/list`, use this to paginate through all groups.
Permission : Team Information.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
groups:
- group_name: Test group
group_id: g:e2db7665347abcd600000000001a2b3c
group_management_type:
.tag: user_managed
member_count: 10
cursor: ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu
has_more: false
operationId: post2TeamGroupsListContinue
x-operation-id-source: derived
/2/team/groups/members/add:
post:
tags:
- Team > Groups
summary: Dropbox groups/members/add
description: 'groups/members/add
scope: `groups.write`
Adds members to a group.
The members are added immediately. However the granting of group-owned resources may take additional time. Use the `groups/job_status/get` to determine whether this process has completed.
Permission : Team member management.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"group\": {\n \".tag\": \"group_id\", \n \"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"\n }, \n \"members\": [\n {\n \"user\": {\n \".tag\": \"team_member_id\", \n \"team_member_id\": \"dbmid:efgh5678\"\n }, \n \"access_type\": \"member\"\n }\n ], \n \"return_members\": true\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
group_info:
group_name: project launch
group_id: g:e2db7665347abcd600000000001a2b3c
group_management_type:
.tag: user_managed
created: 1447255518000
member_count: 5
members:
- profile:
team_member_id: dbmid:1234567
email: mary@lamb.com
email_verified: true
status:
.tag: active
name:
given_name: Franz
surname: Ferdinand
familiar_name: Franz
display_name: Franz Ferdinand (Personal)
abbreviated_name: FF
membership_type:
.tag: full
account_id: dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc
secondary_emails:
- email: apple@orange.com
is_verified: true
- email: banana@honeydew.com
is_verified: true
- email: grape@strawberry.com
is_verified: false
joined_on: '2015-05-12T15:50:38Z'
profile_photo_url: https://dl-web.dropbox.com/account_photo/get/dbaphid%3AAAHWGmIXV3sUuOmBfTz0wPsiqHUpBWvv3ZA?vers=1556069330102&size=128x128
access_type:
.tag: member
async_job_id: '99988877733388'
operationId: post2TeamGroupsMembersAdd
x-operation-id-source: derived
/2/team/groups/members/list:
post:
tags:
- Team > Groups
summary: Dropbox groups/members/list
description: 'groups/members/list
scope: `groups.read`
Lists members of a group.
Permission : Team Information.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"group\": {\n \".tag\": \"group_id\", \n \"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"\n }, \n \"limit\": 100\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
members: []
cursor: ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu
has_more: false
operationId: post2TeamGroupsMembersList
x-operation-id-source: derived
/2/team/groups/members/list/continue:
post:
tags:
- Team > Groups
summary: Dropbox groups/members/list/continue
description: 'groups/members/list/continue
scope: `groups.read`
Once a cursor has been retrieved from `groups/members/list`, use this to paginate through all members of the group.
Permission : Team information.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
members: []
cursor: ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu
has_more: false
operationId: post2TeamGroupsMembersListContinue
x-operation-id-source: derived
/2/team/groups/members/remove:
post:
tags:
- Team > Groups
summary: Dropbox groups/members/remove
description: 'groups/members/remove
scope: `groups.write`
Removes members from a group.
The members are removed immediately. However the revoking of group-owned resources may take additional time. Use the `groups/job_status/get` to determine whether this process has completed.
This method permits removing the only owner of a group, even in cases where this is not possible via the web client.
Permission : Team member management.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"group\": {\n \".tag\": \"group_id\", \n \"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"\n }, \n \"users\": [\n {\n \".tag\": \"team_member_id\", \n \"team_member_id\": \"dbmid:efgh5678\"\n }\n ], \n \"return_members\": true\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
group_info:
group_name: project launch
group_id: g:e2db7665347abcd600000000001a2b3c
group_management_type:
.tag: user_managed
created: 1447255518000
member_count: 5
members:
- profile:
team_member_id: dbmid:1234567
email: mary@lamb.com
email_verified: true
status:
.tag: active
name:
given_name: Franz
surname: Ferdinand
familiar_name: Franz
display_name: Franz Ferdinand (Personal)
abbreviated_name: FF
membership_type:
.tag: full
account_id: dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc
secondary_emails:
- email: apple@orange.com
is_verified: true
- email: banana@honeydew.com
is_verified: true
- email: grape@strawberry.com
is_verified: false
joined_on: '2015-05-12T15:50:38Z'
profile_photo_url: https://dl-web.dropbox.com/account_photo/get/dbaphid%3AAAHWGmIXV3sUuOmBfTz0wPsiqHUpBWvv3ZA?vers=1556069330102&size=128x128
access_type:
.tag: member
async_job_id: '99988877733388'
operationId: post2TeamGroupsMembersRemove
x-operation-id-source: derived
/2/team/groups/members/set_access_type:
post:
tags:
- Team > Groups
summary: Dropbox groups/members/set_access_type
description: 'groups/members/set_access_type
scope: `groups.write`
Sets a member''s access type in a group.
Permission : Team member management.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"group\": {\n \".tag\": \"group_id\", \n \"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"\n }, \n \"user\": {\n \".tag\": \"team_member_id\", \n \"team_member_id\": \"dbmid:efgh5678\"\n }, \n \"access_type\": \"member\", \n \"return_members\": true\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
- .tag: group_info
group_name: project launch
group_id: g:e2db7665347abcd600000000001a2b3c
group_management_type:
.tag: user_managed
created: 1447255518000
member_count: 5
members:
- profile:
team_member_id: dbmid:1234567
email: mary@lamb.com
email_verified: true
status:
.tag: active
name:
given_name: Franz
surname: Ferdinand
familiar_name: Franz
display_name: Franz Ferdinand (Personal)
abbreviated_name: FF
membership_type:
.tag: full
account_id: dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc
secondary_emails:
- email: apple@orange.com
is_verified: true
- email: banana@honeydew.com
is_verified: true
- email: grape@strawberry.com
is_verified: false
joined_on: '2015-05-12T15:50:38Z'
profile_photo_url: https://dl-web.dropbox.com/account_photo/get/dbaphid%3AAAHWGmIXV3sUuOmBfTz0wPsiqHUpBWvv3ZA?vers=1556069330102&size=128x128
access_type:
.tag: member
operationId: post2TeamGroupsMembersSetAccessType
x-operation-id-source: derived
/2/team/groups/update:
post:
tags:
- Team > Groups
summary: Dropbox groups/update
description: 'groups/update
scope: `groups.write`
Updates a group''s name and/or external ID.
Permission : Team member management.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"group\": {\n \".tag\": \"group_id\", \n \"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"\n }, \n \"return_members\": true, \n \"new_group_name\": \"Europe west sales\", \n \"new_group_external_id\": \"sales-234\", \n \"new_group_management_type\": \"company_managed\"\n}"'
parameters:
- name: Content-Type
in: header
schema:
type: string
example: application/json
responses:
'200':
description: OK
headers:
X-Dropbox-Request-Id:
schema:
type: integer
example: '1234'
Content-Type:
schema:
type: string
example: application/json
content:
application/json:
schema:
type: object
example:
group_name: project launch
group_id: g:e2db7665347abcd600000000001a2b3c
group_management_type:
.tag: user_managed
created: 1447255518000
member_count: 5
members:
- profile:
team_member_id: dbmid:1234567
email: mary@lamb.com
email_verified: true
status:
.tag: active
name:
given_name: Franz
surname: Ferdinand
familiar_name: Franz
display_name: Franz Ferdinand (Personal)
abbreviated_name: FF
membership_type:
.tag: full
account_id: dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc
secondary_emails:
- email: apple@orange.com
is_verified: true
- email: banana@honeydew.com
is_verified: true
- email: grape@strawberry.com
is_verified: false
joined_on: '2015-05-12T15:50:38Z'
profile_photo_url: https://dl-web.dropbox.com/account_photo/get/dbaphid%3AAAHWGmIXV3sUuOmBfTz0wPsiqHUpBWvv3ZA?vers=1556069330102&size=128x128
access_type:
.tag: member
operationId: post2TeamGroupsUpdate
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer