This namespace contains endpoints and data types for file request operations.
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:dropbox-file-requests-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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 File Requests 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. This is a collection that includes requests to all endpoints in the Dropbox API.
The Dropbox API is divided in two groups of endpoints: User Endpoints and Business Endpoints. Operations that would most likely be executed by a user, such as file operations, are in the User Endpoints folder. Operations that would most likely be executed by a team administrator, such as adding users to groups, live in the Business Endpoints folder.
If you are new to Dropbox Business and Team Administration, please have a look at the Dropobox Admin Guide.
If you want more information on how to use our API please refer to our Developer Portal.
# What''s in the collection?
The endpoints are organized in the following folders:
* account
* auth
* check
* contacts
* file_properties
* file_requests
* files
* sharing
* team
* team_log
* users
# Authorization
## OAuth 2.0 for API Access
Dropbox uses OAuth 2.0, an open specification, to authorize access to data. To get an OAuth token from Dropbox to enable Postman to access your Dropbox account via the API you’ll need to create a new app on the DBX Platform.
## Creating an App on the DBX Platform
Navigate to https://www.dropbox.com/developers/apps and select “Create app”
1. Choose an API
2. Choose the type of access you need
3. Give your app a name
4. Choose the Dropbox account that will own your app
For reference, please use the Dropbox OAuth guide
## Generating an Access Token
Once you select “Create app” a page will load that displays information about your newly created app. To generate an access token scroll down to “OAuth 2” and click “Generate” beneath “Generated access token.” The token will display as a long string of characters. Copy this token for use with the Postman Collection.
## Adding an Access Token to the requests
In the Postman client, click on the three dots to the right of the collection name to "View more actions."
!Screenshot of adding access token
Then, click "Edit."
Click on the "Variables" tab and, in the row for the `access_token` variable, paste your access token in the `CURRENT VALUE` column. The default value is `your-access-token-here`.
!Screenshot of adding access token
For information on sessions and variables in Postman see the blog post at https://blog.postman.com/sessions-faq/.
# Notes
* Dropbox also has a Postman Collection in the API Network to help administrators with team management workflows. It is called Dropbox Team Admin Workflows.'
version: 1.0.0
servers:
- url: https://api.dropbox.com
security:
- bearerAuth: []
tags:
- name: File Requests
description: This namespace contains endpoints and data types for file request operations.
paths:
/2/file_requests/count:
post:
tags:
- File Requests
summary: Dropbox count
description: 'count
scope: `file_requests.read`
Returns the total number of file requests owned by this user. Includes both open and closed file requests.'
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:
file_request_count: 15
operationId: post2FileRequestsCount
x-operation-id-source: derived
/2/file_requests/create:
post:
tags:
- File Requests
summary: Dropbox create
description: 'create
scope: `file_requests.write`
Creates a file request for this user.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"title\": \"Homework submission\", \n \"destination\": \"/File Requests/Homework\", \n \"deadline\": {\n \"deadline\": \"2020-10-12T17:00:00Z\", \n \"allow_late_uploads\": \"seven_days\"\n }, \n \"open\": 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:
id: oaCAVmEyrqYnkZX9955Y
url: https://www.dropbox.com/request/oaCAVmEyrqYnkZX9955Y
title: Homework submission
created: '2015-10-05T17:00:00Z'
is_open: true
file_count: 3
destination: /File Requests/Homework
deadline:
deadline: '2020-10-12T17:00:00Z'
allow_late_uploads:
.tag: seven_days
operationId: post2FileRequestsCreate
x-operation-id-source: derived
/2/file_requests/delete:
post:
tags:
- File Requests
summary: Dropbox delete
description: 'delete
scope: `file_requests.write`
Delete a batch of closed file requests.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"ids\": [\n \"oaCAVmEyrqYnkZX9955Y\", \n \"BaZmehYoXMPtaRmfTbSG\"\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:
file_requests:
- id: oaCAVmEyrqYnkZX9955Y
url: https://www.dropbox.com/request/oaCAVmEyrqYnkZX9955Y
title: Homework submission
created: '2015-10-05T17:00:00Z'
is_open: true
file_count: 3
destination: /File Requests/Homework
deadline:
deadline: '2020-10-12T17:00:00Z'
allow_late_uploads:
.tag: seven_days
- id: BAJ7IrRGicQKGToykQdB
url: https://www.dropbox.com/request/BAJ7IrRGjcQKGToykQdB
title: Photo contest submission
created: '2015-11-02T04:00:00Z'
is_open: true
file_count: 105
destination: /Photo contest entries
deadline:
deadline: '2020-10-12T17:00:00Z'
- id: rxwMPvK3ATTa0VxOJu5T
url: https://www.dropbox.com/request/rxwMPvK3ATTa0VxOJu5T
title: Wedding photo submission
created: '2015-12-15T13:02:00Z'
is_open: true
file_count: 37
destination: /Wedding photos
operationId: post2FileRequestsDelete
x-operation-id-source: derived
/2/file_requests/delete_all_closed:
post:
tags:
- File Requests
summary: Dropbox delete_all_closed
description: 'delete_all_closed
scope: `file_requests.write`
Delete all closed file requests owned by this user.'
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:
file_requests:
- id: oaCAVmEyrqYnkZX9955Y
url: https://www.dropbox.com/request/oaCAVmEyrqYnkZX9955Y
title: Homework submission
created: '2015-10-05T17:00:00Z'
is_open: true
file_count: 3
destination: /File Requests/Homework
deadline:
deadline: '2020-10-12T17:00:00Z'
allow_late_uploads:
.tag: seven_days
- id: BAJ7IrRGicQKGToykQdB
url: https://www.dropbox.com/request/BAJ7IrRGjcQKGToykQdB
title: Photo contest submission
created: '2015-11-02T04:00:00Z'
is_open: true
file_count: 105
destination: /Photo contest entries
deadline:
deadline: '2020-10-12T17:00:00Z'
- id: rxwMPvK3ATTa0VxOJu5T
url: https://www.dropbox.com/request/rxwMPvK3ATTa0VxOJu5T
title: Wedding photo submission
created: '2015-12-15T13:02:00Z'
is_open: true
file_count: 37
destination: /Wedding photos
operationId: post2FileRequestsDeleteAllClosed
x-operation-id-source: derived
/2/file_requests/get:
post:
tags:
- File Requests
summary: Dropbox get
description: 'get
scope: `file_requests.read`
Returns the specified file request.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"id\": \"oaCAVmEyrqYnkZX9955Y\"\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:
id: oaCAVmEyrqYnkZX9955Y
url: https://www.dropbox.com/request/oaCAVmEyrqYnkZX9955Y
title: Homework submission
created: '2015-10-05T17:00:00Z'
is_open: true
file_count: 3
destination: /File Requests/Homework
deadline:
deadline: '2020-10-12T17:00:00Z'
allow_late_uploads:
.tag: seven_days
operationId: post2FileRequestsGet
x-operation-id-source: derived
/2/file_requests/list_v2:
post:
tags:
- File Requests
summary: Dropbox list
description: 'list
scope: `file_requests.read`
Returns a list of file requests owned by this user. For apps with the app folder permission, this will only return file requests with destinations in the app folder.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"limit\": 1000\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:
file_requests:
- id: oaCAVmEyrqYnkZX9955Y
url: https://www.dropbox.com/request/oaCAVmEyrqYnkZX9955Y
title: Homework submission
created: '2015-10-05T17:00:00Z'
is_open: true
file_count: 3
destination: /File Requests/Homework
deadline:
deadline: '2020-10-12T17:00:00Z'
allow_late_uploads:
.tag: seven_days
- id: BAJ7IrRGicQKGToykQdB
url: https://www.dropbox.com/request/BAJ7IrRGjcQKGToykQdB
title: Photo contest submission
created: '2015-11-02T04:00:00Z'
is_open: true
file_count: 105
destination: /Photo contest entries
deadline:
deadline: '2020-10-12T17:00:00Z'
- id: rxwMPvK3ATTa0VxOJu5T
url: https://www.dropbox.com/request/rxwMPvK3ATTa0VxOJu5T
title: Wedding photo submission
created: '2015-12-15T13:02:00Z'
is_open: true
file_count: 37
destination: /Wedding photos
cursor: ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu
has_more: true
operationId: post2FileRequestsListV2
x-operation-id-source: derived
/2/file_requests/list/continue:
post:
tags:
- File Requests
summary: Dropbox list/continue
description: 'list/continue
scope: `file_requests.read`
Once a cursor has been retrieved from `list:2`, use this to paginate through all file requests. The cursor must come from a previous call to `list:2` or `list/continue`.'
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:
file_requests:
- id: oaCAVmEyrqYnkZX9955Y
url: https://www.dropbox.com/request/oaCAVmEyrqYnkZX9955Y
title: Homework submission
created: '2015-10-05T17:00:00Z'
is_open: true
file_count: 3
destination: /File Requests/Homework
deadline:
deadline: '2020-10-12T17:00:00Z'
allow_late_uploads:
.tag: seven_days
- id: BAJ7IrRGicQKGToykQdB
url: https://www.dropbox.com/request/BAJ7IrRGjcQKGToykQdB
title: Photo contest submission
created: '2015-11-02T04:00:00Z'
is_open: true
file_count: 105
destination: /Photo contest entries
deadline:
deadline: '2020-10-12T17:00:00Z'
- id: rxwMPvK3ATTa0VxOJu5T
url: https://www.dropbox.com/request/rxwMPvK3ATTa0VxOJu5T
title: Wedding photo submission
created: '2015-12-15T13:02:00Z'
is_open: true
file_count: 37
destination: /Wedding photos
cursor: ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu
has_more: true
operationId: post2FileRequestsListContinue
x-operation-id-source: derived
/2/file_requests/update:
post:
tags:
- File Requests
summary: Dropbox update
description: 'update
scope: `file_requests.write`
Update a file request.'
requestBody:
content:
'*/*':
schema:
type: string
example: '"{\n \"id\": \"oaCAVmEyrqYnkZX9955Y\", \n \"title\": \"Homework submission\", \n \"destination\": \"/File Requests/Homework\", \n \"deadline\": {\n \".tag\": \"update\", \n \"deadline\": \"2020-10-12T17:00:00Z\", \n \"allow_late_uploads\": \"seven_days\"\n }, \n \"open\": 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:
id: oaCAVmEyrqYnkZX9955Y
url: https://www.dropbox.com/request/oaCAVmEyrqYnkZX9955Y
title: Homework submission
created: '2015-10-05T17:00:00Z'
is_open: true
file_count: 3
destination: /File Requests/Homework
deadline:
deadline: '2020-10-12T17:00:00Z'
allow_late_uploads:
.tag: seven_days
operationId: post2FileRequestsUpdate
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer