Skip to main content
  • Sign in

Dropbox for HTTP Developers

auth

files

paper

sharing

Dropbox API v2

The Dropbox API allows developers to work with files in Dropbox, including advanced functionality like full-text search, thumbnails, and sharing. The Dropbox API explorer is the easiest way to get started making API calls.

Request and response formats

In general, the Dropbox API uses HTTP POST requests with JSON arguments and JSON responses. Request authentication is via OAuth 2.0 using the Authorization request header or authorization URL parameter.

RPC endpoints

These endpoints accept arguments as JSON in the request body and return results as JSON in the response body. RPC endpoints are on the api.dropboxapi.com domain.

Content-upload endpoints

These endpoints accept file content in the request body, so their arguments are instead passed as JSON in the Dropbox-API-Arg request header or arg URL parameter. These endpoints are on the content.dropboxapi.com domain.

Content-download endpoints

As with content-upload endpoints, arguments are passed in the Dropbox-API-Arg request header or arg URL parameter. The response body contains file content, so the result will appear as JSON in the Dropbox-API-Result response header. These endpoints are also on the content.dropboxapi.com domain.

These endpoints also support HTTP GET along with ETag-based caching (If-None-Match) and HTTP range requests.

Browser-based JavaScript and CORS pre-flight requests

When browser-based JavaScript code makes a cross-site HTTP request, the browser must sometimes send a "pre-flight" check to make sure the server allows cross-site requests. You can avoid the extra round-trip by ensuring your request meets the CORS definition of a "simple cross-site request".

  • Use URL parameters arg and authorization instead of HTTP headers Dropbox-API-Arg and Authorization.
  • Set the Content-Type to "text/plain; charset=dropbox-cors-hack" instead of "application/json" or "application/octet-stream".
  • Always set the URL parameter reject_cors_preflight=true. This makes it easier to catch cases where your code is unintentionally triggering a pre-flight check.

Date format

All dates in the API use UTC and are strings in the ISO 8601 "combined date and time representation" format:

2015-05-15T15:50:38Z

Path formats

Paths are relative to an application's root (either an app folder or the root of a user's Dropbox, depending on the app's access type). The empty string ("") represents the root folder. All other paths must start with a slash (e.g. "/hello/world.txt").

Every file and folder in Dropbox also has an ID (e.g. "id:abc123xyz") that can be obtained from any endpoint that returns metadata. Some endpoints, as noted in the individual endpoint documentation below, can accept IDs in addition to normal paths. A path relative to a folder's ID can be constructed by using a slash (e.g. "id:abc123xyz/hello.txt").

For endpoints that accept performing actions on behalf of a team administrator using the Dropbox-API-Select-Admin header, files may be referenced using a namespace-relative path (e.g. "ns:123456/cupcake.png"). In this case, the namespace ID, "123456", would be the shared_folder_id or team_folder_id of the shared folder or the team folder containing the file or folder, and the path, "/cupcake.png", would be the logical path to the content relative to its shared folder or team folder container.

Case insensitivity

Like Dropbox itself, the Dropbox API is case-insensitive, meaning that /A/B/c.txt is the same file as /a/b/C.txt and is the same file as /a/B/c.txt.

This can cause problems for apps that store file metadata from users in case-sensitive databases (such as SQLite or Postgres). Case insensitive collations should be used when storing Dropbox metadata in such databases. Alternatively, developers need to make sure their query operators are explicitly case insensitive.

Also, while Dropbox is case-insensitive, it makes efforts to be case-preserving. Metadata.name will contain the correct case. Metadata.path_display usually will contain the correct case, but sometimes only in the last path component. If your app needs the correct case for all components, it can get it from the Metadata.name or last path component of each relevant Metadata.path_display entry.

Authorization

Dropbox supports OAuth 2.0 for authorizing API requests. Find out more in our OAuth guide. Authorized requests to the API should use an Authorization header with the value Bearer <TOKEN>, where <TOKEN> is an access token obtained through the OAuth flow.

Note: OAuth is an authorization protocol, not an authentication protocol. Dropbox should not be used as an identity provider.

/oauth2/authorize

Description

This starts the OAuth 2.0 authorization flow. This isn't an API call—it's the web page that lets the user sign in to Dropbox and authorize your app. After the user decides whether or not to authorize your app, they will be redirected to the URI specified by redirect_uri.

OAuth 2.0 supports two authorization flows:

  • The code flow returns a code via the redirect_uri callback which should then be converted into a bearer token using the /oauth2/token call. This is the recommended flow for apps that are running on a server.
  • The token or implicit grant flow returns the bearer token via the redirect_uri callback, rather than requiring your app to make a second call to a server. This is useful for pure client-side apps, such as mobile apps or JavaScript-based apps.

For more information on the two flows, see Section 1.3 of the OAuth 2 spec.

URL Structure
https://www.dropbox.com/oauth2/authorize

Note: This is the only step that requires an endpoint on www.dropbox.com. All other API requests are done via api.dropboxapi.com, content.dropboxapi.com, or notify.dropboxapi.com.

Method
GET
Parameters
response_type String The grant type requested, either token or code.
client_id String The app's key, found in the App Console.
redirect_uri String? Where to redirect the user after authorization has completed. This must be the exact URI registered in the App Console; even 'localhost' must be listed if it is used for testing. All redirect URIs must be HTTPS except for localhost URIs. A redirect URI is required for the token flow, but optional for the code flow. If the redirect URI is omitted, the code will be presented directly to the user and they will be invited to enter the information in your app.
state String? Up to 500 bytes of arbitrary data that will be passed back to your redirect URI. This parameter should be used to protect against cross-site request forgery (CSRF). See Sections 4.4.1.8 and 4.4.2.5 of the OAuth 2.0 threat model spec.
require_role String? If this parameter is specified, the user will be asked to authorize with a particular type of Dropbox account, either work for a team account or personal for a personal account. Your app should still verify the type of Dropbox account after authorization since the user could modify or remove the require_role parameter.
force_reapprove Boolean? Whether or not to force the user to approve the app again if they've already done so. If false (default), a user who has already approved the application may be automatically redirected to the URI specified by redirect_uri. If true, the user will not be automatically redirected and will have to approve the app again.
disable_signup Boolean? When true (default is false) users will not be able to sign up for a Dropbox account via the authorization page. Instead, the authorization page will show a link to the Dropbox iOS app in the App Store. This is only intended for use when necessary for compliance with App Store policies.
Returns

Because /oauth2/authorize is a website, there is no direct return value. However, after the user authorizes your app, they will be sent to your redirect URI. The type of response varies based on the response_type.

Code flow

These parameters are passed in the query string (after the ? in the URL):

code String The authorization code, which can be used to attain a bearer token by calling /oauth2/token.
state String The state content, if any, originally passed to /oauth2/authorize.

Sample response 

[REDIRECT_URI]?code=ABCDEFG&state=[STATE]

Token flow

These parameters are passed in the URL fragment (after the # in the URL).

Note: as fragments, these parameters can be modified by the user and must not be trusted server-side. If any of these fields are being used server-side, please consider using the Code flow, or alternatively using the fields returned from /get_current_account instead.

access_token String A token which can be used to make calls to the Dropbox API.
token_type String The type of token, which will always be bearer.
account_id String A user's account identifier used by API v2.
team_id String A team's identifier used by API v2.
uid String Deprecated. The API v1 user/team identifier. Please use account_id instead, or if using the Dropbox Business API, team_id.
state String The state content, if any, originally passed to /oauth2/authorize.

Sample response 

[REDIRECT_URI]#access_token=ABCDEFG&token_type=bearer&account_id=dbid%3AAAH4f99T0taONIb-OurWxbNQ6ywGRopQngc&uid=12345&state=[STATE]
Errors

In either flow, if an error occurs, including if the user has chosen not to authorize the app, the following parameters will be included in the redirect URI:

error String An error code per Section 4.1.2.1 of the OAuth 2.0 spec.
error_description String A user-friendly description of the error that occurred.
state String The state content, if any, originally passed to /oauth2/authorize.

/oauth2/token

Description

This endpoint only applies to apps using the authorization code flow. An app calls this endpoint to acquire a bearer token once the user has authorized the app.

Calls to /oauth2/token need to be authenticated using the apps's key and secret. These can either be passed as POST parameters (see parameters below) or via HTTP basic authentication. If basic authentication is used, the app key should be provided as the username, and the app secret should be provided as the password.

URL Structure
https://api.dropboxapi.com/oauth2/token
Method
POST
Parameters
code String The code acquired by directing users to /oauth2/authorize?response_type=code.
grant_type String The grant type, which must be authorization_code.
client_id String? If credentials are passed in POST parameters, this parameter should be present and should be the app's key (found in the App Console).
client_secret String? If credentials are passed in POST parameters, this parameter should be present and should be the app's secret.
redirect_uri String? Only used to validate that it matches the original /oauth2/authorize, not used to redirect again.
Returns

A JSON-encoded dictionary including an access token (access_token), token type (token_type), an API v2 user ID (account_id), or if team-linked, an API v2 team ID (team_id) instead. The API v1 identifier value (uid) is deprecated and should no longer be used. The token type will always be "bearer".

Sample response 

{"access_token": "ABCDEFG", "token_type": "bearer", "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc", "uid": "12345"}

Errors

Errors are returned using standard HTTP error code syntax. Depending on the status code, the response body may be in JSON or plaintext.

Errors by status code

CodeDescription
400Bad input parameter. The response body is a plaintext message with more information.
401Bad or expired token. This can happen if the access token is expired or if the access token has been revoked by Dropbox or the user. To fix this, you should re-authenticate the user.
409Endpoint-specific error. Look to the JSON response body for the specifics of the error.
429Your app is making too many requests for the given user or team and is being rate limited. Your app should wait for the number of seconds specified in the "Retry-After" response header before trying again. The Content-Type of the response can be JSON or plaintext. If it is JSON, it will have a reason field with one of the following values:
too_many_requests Void Your app has been making too many requests in the past few minutes.
too_many_write_operations Void They are too many write operations happening in the user's Dropbox.
5xxAn error occurred on the Dropbox servers. Check status.dropbox.com for announcements about Dropbox service issues.

Endpoint-specific errors (409)

The following table describes the top-level JSON object attributes present in the body of 409 responses.
KeyDescription
errorA value that conforms to the error data type schema defined in the definition of each route.
error_summaryA string that summarizes the value of the "error" key. It is a concatenation of the hierarchy of union tags that make up the error. While this provides a human-readable error string, "error_summary" should not be used for programmatic error handling. To disincentive this, we append a random number of "." characters at the end of the string.
user_messageAn optional field. If present, it includes a message that can be shown directly to the end user of your app. You should show this message if your app is unprepared to programmatically handle the error returned by an endpoint.

Generate access token

Use the dropdown to select which app to make API calls with. An access token for the chosen app will be generated and inserted into the examples below.

By generating an access token, you will be able to make API calls for your own account without going through the authorization flow. To obtain access tokens for other users, use the standard OAuth flow.

auth

/token/from_oauth1

Description

Creates an OAuth 2.0 access token from the supplied OAuth 1.0 access token.

URL Structure
https://api.dropboxapi.com/2/auth/token/from_oauth1
Authentication
App Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/auth/token/from_oauth1 \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"oauth1_token\": \"qievr8hamyg6ndck\",\"oauth1_token_secret\": \"qomoftv0472git7\"}"
Parameters
{
    "oauth1_token": "qievr8hamyg6ndck",
    "oauth1_token_secret": "qomoftv0472git7"
}
TokenFromOAuth1Arg
oauth1_token String(min_length=1) The supplied OAuth 1.0 access token.
oauth1_token_secret String(min_length=1) The token secret associated with the supplied access token.
Returns
{
    "oauth2_token": "9mCrkS7BIdAAAAAAAAAAHHS0TsSnpYvKQVtKdBnN5IuzhYOGblSgTcHgBFKFMmFn"
}
TokenFromOAuth1Result
oauth2_token String(min_length=1) The OAuth 2.0 token generated from the supplied OAuth 1.0 token.
Errors
Example: invalid_oauth1_token_info 
{
    "error_summary": "invalid_oauth1_token_info/...",
    "error": {
        ".tag": "invalid_oauth1_token_info"
    }
}
Example: app_id_mismatch 
{
    "error_summary": "app_id_mismatch/...",
    "error": {
        ".tag": "app_id_mismatch"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TokenFromOAuth1Error (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_oauth1_token_info Void Part or all of the OAuth 1.0 access token info is invalid.
app_id_mismatch Void The authorized app does not match the app associated with the supplied access token.

/token/revoke

Description

Disables the access token used to authenticate the call.

URL Structure
https://api.dropboxapi.com/2/auth/token/revoke
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/auth/token/revoke \
    --header "Authorization: Bearer "
Parameters

No parameters.

Returns

No return values.

Errors

No errors.

files

This namespace contains endpoints and data types for basic file operations.

/copy

Description

Copy a file or folder to a different location in the user's Dropbox.
If the source path is a folder all its contents will be copied.

URL Structure
https://api.dropboxapi.com/2/files/copy
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/copy \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"from_path\": \"/Homework/math\",\"to_path\": \"/Homework/algebra\",\"allow_shared_folder\": false,\"autorename\": false}"
Parameters
{
    "from_path": "/Homework/math",
    "to_path": "/Homework/algebra",
    "allow_shared_folder": false,
    "autorename": false
}
RelocationArg
from_path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to be copied or moved.
to_path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox that is the destination.
allow_shared_folder Boolean If true, copy will copy contents in shared folder, otherwise RelocationError.cant_copy_shared_folder will be returned if from_path contains shared folder. This field is always true for move. The default for this field is False.
autorename Boolean If there's a conflict, have the Dropbox server try to autorename the file to avoid the conflict. The default for this field is False.
Returns
{
    ".tag": "file",
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
{
    ".tag": "folder",
    "name": "math",
    "id": "id:a4ayc_80_OEAAAAAAAAAXz",
    "path_lower": "/homework/math",
    "path_display": "/Homework/math",
    "sharing_info": {
        "read_only": false,
        "parent_shared_folder_id": "84528192421",
        "traverse_only": false,
        "no_access": false
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ]
}
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
Errors
Example: cant_copy_shared_folder 
{
    "error_summary": "cant_copy_shared_folder/...",
    "error": {
        ".tag": "cant_copy_shared_folder"
    }
}
Example: cant_nest_shared_folder 
{
    "error_summary": "cant_nest_shared_folder/...",
    "error": {
        ".tag": "cant_nest_shared_folder"
    }
}
Example: cant_move_folder_into_itself 
{
    "error_summary": "cant_move_folder_into_itself/...",
    "error": {
        ".tag": "cant_move_folder_into_itself"
    }
}
Example: too_many_files 
{
    "error_summary": "too_many_files/...",
    "error": {
        ".tag": "too_many_files"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RelocationError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
from_lookup LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
from_write WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
to WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
cant_copy_shared_folder Void Shared folders can't be copied.
cant_nest_shared_folder Void Your move operation would result in nested shared folders. This is not allowed.
cant_move_folder_into_itself Void You cannot move a folder into itself.
too_many_files Void The operation would involve more than 10,000 files and folders.

/copy_batch

Description

Copy multiple files or folders to different locations at once in the user's Dropbox.
If RelocationBatchArg.allow_shared_folder is false, this route is atomic. If on entry failes, the whole transaction will abort. If RelocationBatchArg.allow_shared_folder is true, not atomicity is guaranteed, but you will be able to copy the contents of shared folders to new locations.
This route will return job ID immediately and do the async copy job in background. Please use copy_batch/check to check the job status.

URL Structure
https://api.dropboxapi.com/2/files/copy_batch
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/copy_batch \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"entries\": [{\"from_path\": \"/Homework/math\",\"to_path\": \"/Homework/algebra\"}],\"allow_shared_folder\": false,\"autorename\": false}"
Parameters
{
    "entries": [
        {
            "from_path": "/Homework/math",
            "to_path": "/Homework/algebra"
        }
    ],
    "allow_shared_folder": false,
    "autorename": false
}
RelocationBatchArg
entries List of (RelocationPath) List of entries to be moved or copied. Each entry is RelocationPath.
RelocationPath
from_path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to be copied or moved.
to_path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox that is the destination.
allow_shared_folder Boolean If true, copy_batch will copy contents in shared folder, otherwise RelocationError.cant_copy_shared_folder will be returned if RelocationPath.from_path contains shared folder. This field is always true for move_batch. The default for this field is False.
autorename Boolean If there's a conflict with any file, have the Dropbox server try to autorename that file to avoid the conflict. The default for this field is False.
Returns
Example: complete 
{
    ".tag": "complete",
    "entries": [
        {
            "metadata": {
                ".tag": "file",
                "name": "Prime_Numbers.txt",
                "id": "id:a4ayc_80_OEAAAAAAAAAXw",
                "client_modified": "2015-05-12T15:50:38Z",
                "server_modified": "2015-05-12T15:50:38Z",
                "rev": "a1c10ce0dd78",
                "size": 7212,
                "path_lower": "/homework/math/prime_numbers.txt",
                "path_display": "/Homework/math/Prime_Numbers.txt",
                "sharing_info": {
                    "read_only": true,
                    "parent_shared_folder_id": "84528192421",
                    "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
                },
                "property_groups": [
                    {
                        "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                        "fields": [
                            {
                                "name": "Security Policy",
                                "value": "Confidential"
                            }
                        ]
                    }
                ],
                "has_explicit_shared_members": false
            }
        }
    ]
}
Example: async_job_id 
{
    ".tag": "async_job_id",
    "async_job_id": "34g93hh34h04y384084"
}
Example: other 
{
    ".tag": "other"
}
RelocationBatchLaunch (open union)
Result returned by copy_batch or move_batch that may either launch an asynchronous job or complete synchronously. The value will be one of the following datatypes. New values may be introduced as our API evolves.
async_job_id String(min_length=1) This response indicates that the processing is asynchronous. The string is an id that can be used to obtain the status of the asynchronous job.
complete RelocationBatchResult
RelocationBatchResult
entries List of (RelocationResult)
RelocationResult
metadata Metadata
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
Errors

No errors.

/copy_batch/check

Description

Returns the status of an asynchronous job for copy_batch. If success, it returns list of results for each entry.

URL Structure
https://api.dropboxapi.com/2/files/copy_batch/check
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/copy_batch/check \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"async_job_id\": \"34g93hh34h04y384084\"}"
Parameters
{
    "async_job_id": "34g93hh34h04y384084"
}
PollArg
Arguments for methods that poll the status of an asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace.
async_job_id String(min_length=1) Id of the asynchronous job. This is the value of a response returned from the method that launched the job.
Returns
{
    ".tag": "complete",
    "entries": [
        {
            "metadata": {
                ".tag": "file",
                "name": "Prime_Numbers.txt",
                "id": "id:a4ayc_80_OEAAAAAAAAAXw",
                "client_modified": "2015-05-12T15:50:38Z",
                "server_modified": "2015-05-12T15:50:38Z",
                "rev": "a1c10ce0dd78",
                "size": 7212,
                "path_lower": "/homework/math/prime_numbers.txt",
                "path_display": "/Homework/math/Prime_Numbers.txt",
                "sharing_info": {
                    "read_only": true,
                    "parent_shared_folder_id": "84528192421",
                    "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
                },
                "property_groups": [
                    {
                        "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                        "fields": [
                            {
                                "name": "Security Policy",
                                "value": "Confidential"
                            }
                        ]
                    }
                ],
                "has_explicit_shared_members": false
            }
        }
    ]
}
Example: in_progress 
{
    ".tag": "in_progress"
}
RelocationBatchJobStatus (union)
The value will be one of the following datatypes:
in_progress Void The asynchronous job is still in progress.
complete RelocationBatchResult The copy or move batch job has finished.
RelocationBatchResult
entries List of (RelocationResult)
RelocationResult
metadata Metadata
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
failed RelocationBatchError The copy or move batch job has failed with exception.
RelocationBatchError (union)
The value will be one of the following datatypes:
from_lookup LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
from_write WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
to WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
cant_copy_shared_folder Void Shared folders can't be copied.
cant_nest_shared_folder Void Your move operation would result in nested shared folders. This is not allowed.
cant_move_folder_into_itself Void You cannot move a folder into itself.
too_many_files Void The operation would involve more than 10,000 files and folders.
duplicated_or_nested_paths Void There are duplicated/nested paths among RelocationArg.from_path and RelocationArg.to_path.
too_many_write_operations Void There are too many write operations in user's Dropbox. Please retry this request.
Errors
Example: invalid_async_job_id 
{
    "error_summary": "invalid_async_job_id/...",
    "error": {
        ".tag": "invalid_async_job_id"
    }
}
Example: internal_error 
{
    "error_summary": "internal_error/...",
    "error": {
        ".tag": "internal_error"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
PollError (open union)
Error returned by methods for polling the status of asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_async_job_id Void The job ID is invalid.
internal_error Void Something went wrong with the job on Dropbox's end. You'll need to verify that the action you were taking succeeded, and if not, try again. This should happen very rarely.

/copy_reference/get

Description

Get a copy reference to a file or folder. This reference string can be used to save that file or folder to another user's Dropbox by passing it to copy_reference/save.

URL Structure
https://api.dropboxapi.com/2/files/copy_reference/get
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/copy_reference/get \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/video.mp4\"}"
Parameters
{
    "path": "/video.mp4"
}
GetCopyReferenceArg
path String(pattern="(/(.|[\r\n])*|id:.*)|(rev:[0-9a-f]{9,})|(ns:[0-9]+(/.*)?)") The path to the file or folder you want to get a copy reference to.
Returns
{
    "metadata": {
        ".tag": "file",
        "name": "Prime_Numbers.txt",
        "id": "id:a4ayc_80_OEAAAAAAAAAXw",
        "client_modified": "2015-05-12T15:50:38Z",
        "server_modified": "2015-05-12T15:50:38Z",
        "rev": "a1c10ce0dd78",
        "size": 7212,
        "path_lower": "/homework/math/prime_numbers.txt",
        "path_display": "/Homework/math/Prime_Numbers.txt",
        "sharing_info": {
            "read_only": true,
            "parent_shared_folder_id": "84528192421",
            "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
        },
        "property_groups": [
            {
                "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                "fields": [
                    {
                        "name": "Security Policy",
                        "value": "Confidential"
                    }
                ]
            }
        ],
        "has_explicit_shared_members": false
    },
    "copy_reference": "z1X6ATl6aWtzOGq0c3g5Ng",
    "expires": "2045-05-12T15:50:38Z"
}
GetCopyReferenceResult
metadata Metadata Metadata of the file or folder.
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
copy_reference String A copy reference to the file or folder.
expires Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The expiration date of the copy reference. This value is currently set to be far enough in the future so that expiration is effectively not an issue.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GetCopyReferenceError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.

/copy_reference/save

Description

Save a copy reference returned by copy_reference/get to the user's Dropbox.

URL Structure
https://api.dropboxapi.com/2/files/copy_reference/save
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/copy_reference/save \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"copy_reference\": \"z1X6ATl6aWtzOGq0c3g5Ng\",\"path\": \"/video.mp4\"}"
Parameters
{
    "copy_reference": "z1X6ATl6aWtzOGq0c3g5Ng",
    "path": "/video.mp4"
}
SaveCopyReferenceArg
copy_reference String A copy reference returned by copy_reference/get.
path String(pattern="/(.|[\r\n])*") Path in the user's Dropbox that is the destination.
Returns
{
    "metadata": {
        ".tag": "file",
        "name": "Prime_Numbers.txt",
        "id": "id:a4ayc_80_OEAAAAAAAAAXw",
        "client_modified": "2015-05-12T15:50:38Z",
        "server_modified": "2015-05-12T15:50:38Z",
        "rev": "a1c10ce0dd78",
        "size": 7212,
        "path_lower": "/homework/math/prime_numbers.txt",
        "path_display": "/Homework/math/Prime_Numbers.txt",
        "sharing_info": {
            "read_only": true,
            "parent_shared_folder_id": "84528192421",
            "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
        },
        "property_groups": [
            {
                "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                "fields": [
                    {
                        "name": "Security Policy",
                        "value": "Confidential"
                    }
                ]
            }
        ],
        "has_explicit_shared_members": false
    }
}
SaveCopyReferenceResult
metadata Metadata The metadata of the saved file or folder in the user's Dropbox.
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
Errors
Example: invalid_copy_reference 
{
    "error_summary": "invalid_copy_reference/...",
    "error": {
        ".tag": "invalid_copy_reference"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: not_found 
{
    "error_summary": "not_found/...",
    "error": {
        ".tag": "not_found"
    }
}
Example: too_many_files 
{
    "error_summary": "too_many_files/...",
    "error": {
        ".tag": "too_many_files"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
SaveCopyReferenceError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
invalid_copy_reference Void The copy reference is invalid.
no_permission Void You don't have permission to save the given copy reference. Please make sure this app is same app which created the copy reference and the source user is still linked to the app.
not_found Void The file referenced by the copy reference cannot be found.
too_many_files Void The operation would involve more than 10,000 files and folders.

/create_folder

Description

Create a folder at a given path.

URL Structure
https://api.dropboxapi.com/2/files/create_folder
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/create_folder \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/Homework/math\",\"autorename\": false}"
Parameters
{
    "path": "/Homework/math",
    "autorename": false
}
CreateFolderArg
path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to create.
autorename Boolean If there's a conflict, have the Dropbox server try to autorename the folder to avoid the conflict. The default for this field is False.
Returns
{
    "name": "math",
    "id": "id:a4ayc_80_OEAAAAAAAAAXz",
    "path_lower": "/homework/math",
    "path_display": "/Homework/math",
    "sharing_info": {
        "read_only": false,
        "parent_shared_folder_id": "84528192421",
        "traverse_only": false,
        "no_access": false
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ]
}
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
Errors
CreateFolderError (union)
The value will be one of the following datatypes:
path WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.

/delete

Description

Delete the file or folder at a given path.
If the path is a folder, all its contents will be deleted too.
A successful response indicates that the file or folder was deleted. The returned metadata will be the corresponding FileMetadata or FolderMetadata for the item at time of deletion, and not a DeletedMetadata object.

URL Structure
https://api.dropboxapi.com/2/files/delete
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/delete \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/Homework/math/Prime_Numbers.txt\"}"
Parameters
{
    "path": "/Homework/math/Prime_Numbers.txt"
}
DeleteArg
path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to delete.
Returns
{
    ".tag": "file",
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
{
    ".tag": "folder",
    "name": "math",
    "id": "id:a4ayc_80_OEAAAAAAAAAXz",
    "path_lower": "/homework/math",
    "path_display": "/Homework/math",
    "sharing_info": {
        "read_only": false,
        "parent_shared_folder_id": "84528192421",
        "traverse_only": false,
        "no_access": false
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ]
}
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
DeleteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path_lookup LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
path_write WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.

/delete_batch

Description

Delete multiple files/folders at once.
This route is asynchronous, which returns a job ID immediately and runs the delete batch asynchronously. Use delete_batch/check to check the job status.

URL Structure
https://api.dropboxapi.com/2/files/delete_batch
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/delete_batch \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"entries\": [{\"path\": \"/Homework/math/Prime_Numbers.txt\"}]}"
Parameters
{
    "entries": [
        {
            "path": "/Homework/math/Prime_Numbers.txt"
        }
    ]
}
DeleteBatchArg
entries List of (DeleteArg)
DeleteArg
path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to delete.
Returns
Example: complete 
{
    ".tag": "complete",
    "entries": [
        {
            ".tag": "success",
            "metadata": {
                ".tag": "file",
                "name": "Prime_Numbers.txt",
                "id": "id:a4ayc_80_OEAAAAAAAAAXw",
                "client_modified": "2015-05-12T15:50:38Z",
                "server_modified": "2015-05-12T15:50:38Z",
                "rev": "a1c10ce0dd78",
                "size": 7212,
                "path_lower": "/homework/math/prime_numbers.txt",
                "path_display": "/Homework/math/Prime_Numbers.txt",
                "sharing_info": {
                    "read_only": true,
                    "parent_shared_folder_id": "84528192421",
                    "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
                },
                "property_groups": [
                    {
                        "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                        "fields": [
                            {
                                "name": "Security Policy",
                                "value": "Confidential"
                            }
                        ]
                    }
                ],
                "has_explicit_shared_members": false
            }
        }
    ]
}
Example: async_job_id 
{
    ".tag": "async_job_id",
    "async_job_id": "34g93hh34h04y384084"
}
Example: other 
{
    ".tag": "other"
}
DeleteBatchLaunch (open union)
Result returned by delete_batch that may either launch an asynchronous job or complete synchronously. The value will be one of the following datatypes. New values may be introduced as our API evolves.
async_job_id String(min_length=1) This response indicates that the processing is asynchronous. The string is an id that can be used to obtain the status of the asynchronous job.
complete DeleteBatchResult
DeleteBatchResult
entries List of (DeleteBatchResultEntry)
DeleteBatchResultEntry (union)
The value will be one of the following datatypes:
success DeleteResult
DeleteResult
metadata Metadata
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
failure DeleteError
DeleteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path_lookup LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
path_write WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
Errors

No errors.

/delete_batch/check

Description

Returns the status of an asynchronous job for delete_batch. If success, it returns list of result for each entry.

URL Structure
https://api.dropboxapi.com/2/files/delete_batch/check
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/delete_batch/check \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"async_job_id\": \"34g93hh34h04y384084\"}"
Parameters
{
    "async_job_id": "34g93hh34h04y384084"
}
PollArg
Arguments for methods that poll the status of an asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace.
async_job_id String(min_length=1) Id of the asynchronous job. This is the value of a response returned from the method that launched the job.
Returns
{
    ".tag": "complete",
    "entries": [
        {
            ".tag": "success",
            "metadata": {
                ".tag": "file",
                "name": "Prime_Numbers.txt",
                "id": "id:a4ayc_80_OEAAAAAAAAAXw",
                "client_modified": "2015-05-12T15:50:38Z",
                "server_modified": "2015-05-12T15:50:38Z",
                "rev": "a1c10ce0dd78",
                "size": 7212,
                "path_lower": "/homework/math/prime_numbers.txt",
                "path_display": "/Homework/math/Prime_Numbers.txt",
                "sharing_info": {
                    "read_only": true,
                    "parent_shared_folder_id": "84528192421",
                    "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
                },
                "property_groups": [
                    {
                        "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                        "fields": [
                            {
                                "name": "Security Policy",
                                "value": "Confidential"
                            }
                        ]
                    }
                ],
                "has_explicit_shared_members": false
            }
        }
    ]
}
Example: in_progress 
{
    ".tag": "in_progress"
}
Example: other 
{
    ".tag": "other"
}
DeleteBatchJobStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
in_progress Void The asynchronous job is still in progress.
complete DeleteBatchResult The batch delete has finished.
DeleteBatchResult
entries List of (DeleteBatchResultEntry)
DeleteBatchResultEntry (union)
The value will be one of the following datatypes:
success DeleteResult
DeleteResult
metadata Metadata
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
failure DeleteError
DeleteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path_lookup LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
path_write WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
failed DeleteBatchError The batch delete has failed.
DeleteBatchError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
too_many_write_operations Void There are too many write operations in user's Dropbox. Please retry this request.
Errors
Example: invalid_async_job_id 
{
    "error_summary": "invalid_async_job_id/...",
    "error": {
        ".tag": "invalid_async_job_id"
    }
}
Example: internal_error 
{
    "error_summary": "internal_error/...",
    "error": {
        ".tag": "internal_error"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
PollError (open union)
Error returned by methods for polling the status of asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_async_job_id Void The job ID is invalid.
internal_error Void Something went wrong with the job on Dropbox's end. You'll need to verify that the action you were taking succeeded, and if not, try again. This should happen very rarely.

/download

Description

Download a file from a user's Dropbox.

URL Structure
https://content.dropboxapi.com/2/files/download
Authentication
User Authentication
Endpoint format
Content-download
Example
Get access token for: 
curl -X POST https://content.dropboxapi.com/2/files/download \
    --header "Authorization: Bearer " \
    --header "Dropbox-API-Arg: {\"path\": \"/Homework/math/Prime_Numbers.txt\"}"
Parameters
{
    "path": "/Homework/math/Prime_Numbers.txt"
}
Example: id 
{
    "path": "id:a4ayc_80_OEAAAAAAAAAYa"
}
Example: rev 
{
    "path": "rev:a1c10ce0dd78"
}
DownloadArg
path String(pattern="(/(.|[\r\n])*|id:.*)|(rev:[0-9a-f]{9,})|(ns:[0-9]+(/.*)?)") The path of the file to download.
rev String(min_length=9, pattern="[0-9a-f]+")? Deprecated. Please specify revision in path instead. This field is optional.
Returns
{
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
DownloadError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.

/get_metadata

Description

Returns the metadata for a file or folder.
Note: Metadata for the root folder is unsupported.

URL Structure
https://api.dropboxapi.com/2/files/get_metadata
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/get_metadata \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/Homework/math\",\"include_media_info\": false,\"include_deleted\": false,\"include_has_explicit_shared_members\": false}"
Parameters
{
    "path": "/Homework/math",
    "include_media_info": false,
    "include_deleted": false,
    "include_has_explicit_shared_members": false
}
Example: id 
{
    "path": "id:a4ayc_80_OEAAAAAAAAAYa",
    "include_media_info": false,
    "include_deleted": false,
    "include_has_explicit_shared_members": false
}
Example: rev 
{
    "path": "rev:a1c10ce0dd78",
    "include_media_info": false,
    "include_deleted": false,
    "include_has_explicit_shared_members": false
}
GetMetadataArg
path String(pattern="(/(.|[\r\n])*|id:.*)|(rev:[0-9a-f]{9,})|(ns:[0-9]+(/.*)?)") The path of a file or folder on Dropbox.
include_media_info Boolean If true, FileMetadata.media_info is set for photo and video. The default for this field is False.
include_deleted Boolean If true, DeletedMetadata will be returned for deleted file or folder, otherwise LookupError.not_found will be returned. The default for this field is False.
include_has_explicit_shared_members Boolean If true, the results will include a flag for each file indicating whether or not that file has any explicit members. The default for this field is False.
Returns
{
    ".tag": "file",
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
{
    ".tag": "folder",
    "name": "math",
    "id": "id:a4ayc_80_OEAAAAAAAAAXz",
    "path_lower": "/homework/math",
    "path_display": "/Homework/math",
    "sharing_info": {
        "read_only": false,
        "parent_shared_folder_id": "84528192421",
        "traverse_only": false,
        "no_access": false
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ]
}
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
Errors
GetMetadataError (union)
The value will be one of the following datatypes:
path LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.

/get_preview

Description

Get a preview for a file. Currently previews are only generated for the files with the following extensions: .doc, .docx, .docm, .ppt, .pps, .ppsx, .ppsm, .pptx, .pptm, .xls, .xlsx, .xlsm, .rtf.

URL Structure
https://content.dropboxapi.com/2/files/get_preview
Authentication
User Authentication
Endpoint format
Content-download
Example
Get access token for: 
curl -X POST https://content.dropboxapi.com/2/files/get_preview \
    --header "Authorization: Bearer " \
    --header "Dropbox-API-Arg: {\"path\": \"/word.docx\"}"
Parameters
{
    "path": "/word.docx"
}
Example: id 
{
    "path": "id:a4ayc_80_OEAAAAAAAAAYa"
}
Example: rev 
{
    "path": "rev:a1c10ce0dd78"
}
PreviewArg
path String(pattern="(/(.|[\r\n])*|id:.*)|(rev:[0-9a-f]{9,})|(ns:[0-9]+(/.*)?)") The path of the file to preview.
rev String(min_length=9, pattern="[0-9a-f]+")? Deprecated. Please specify revision in path instead. This field is optional.
Returns
{
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
Errors
Example: in_progress 
{
    "error_summary": "in_progress/...",
    "error": {
        ".tag": "in_progress"
    }
}
Example: unsupported_extension 
{
    "error_summary": "unsupported_extension/...",
    "error": {
        ".tag": "unsupported_extension"
    }
}
Example: unsupported_content 
{
    "error_summary": "unsupported_content/...",
    "error": {
        ".tag": "unsupported_content"
    }
}
PreviewError (union)
The value will be one of the following datatypes:
path LookupError An error occurs when downloading metadata for the file.
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
in_progress Void This preview generation is still in progress and the file is not ready for preview yet.
unsupported_extension Void The file extension is not supported preview generation.
unsupported_content Void The file content is not supported for preview generation.

/get_thumbnail

Description

Get a thumbnail for an image.
This method currently supports files with the following file extensions: jpg, jpeg, png, tiff, tif, gif and bmp. Photos that are larger than 20MB in size won't be converted to a thumbnail.

URL Structure
https://content.dropboxapi.com/2/files/get_thumbnail
Authentication
User Authentication
Endpoint format
Content-download
Example
Get access token for: 
curl -X POST https://content.dropboxapi.com/2/files/get_thumbnail \
    --header "Authorization: Bearer " \
    --header "Dropbox-API-Arg: {\"path\": \"/image.jpg\",\"format\": \"jpeg\",\"size\": \"w64h64\"}"
Parameters
{
    "path": "/image.jpg",
    "format": "jpeg",
    "size": "w64h64"
}
Example: id 
{
    "path": "id:a4ayc_80_OEAAAAAAAAAYa",
    "format": "jpeg",
    "size": "w64h64"
}
Example: rev 
{
    "path": "rev:a1c10ce0dd78",
    "format": "jpeg",
    "size": "w64h64"
}
ThumbnailArg
path String(pattern="(/(.|[\r\n])*|id:.*)|(rev:[0-9a-f]{9,})|(ns:[0-9]+(/.*)?)") The path to the image file you want to thumbnail.
format ThumbnailFormat The format for the thumbnail image, jpeg (default) or png. For images that are photos, jpeg should be preferred, while png is better for screenshots and digital arts. The default for this union is jpeg.
ThumbnailFormat (union)
The value will be one of the following datatypes:
jpeg Void
png Void
size ThumbnailSize The size for the thumbnail image. The default for this union is w64h64.
ThumbnailSize (union)
The value will be one of the following datatypes:
w32h32 Void 32 by 32 px.
w64h64 Void 64 by 64 px.
w128h128 Void 128 by 128 px.
w640h480 Void 640 by 480 px.
w1024h768 Void 1024 by 768.
Returns
{
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
Errors
Example: unsupported_extension 
{
    "error_summary": "unsupported_extension/...",
    "error": {
        ".tag": "unsupported_extension"
    }
}
Example: unsupported_image 
{
    "error_summary": "unsupported_image/...",
    "error": {
        ".tag": "unsupported_image"
    }
}
Example: conversion_error 
{
    "error_summary": "conversion_error/...",
    "error": {
        ".tag": "conversion_error"
    }
}
ThumbnailError (union)
The value will be one of the following datatypes:
path LookupError An error occurs when downloading metadata for the image.
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
unsupported_extension Void The file extension doesn't allow conversion to a thumbnail.
unsupported_image Void The image cannot be converted to a thumbnail.
conversion_error Void An error occurs during thumbnail conversion.

/list_folder

Description

Starts returning the contents of a folder. If the result's ListFolderResult.has_more field is true, call list_folder/continue with the returned ListFolderResult.cursor to retrieve more entries.
If you're using ListFolderArg.recursive set to true to keep a local cache of the contents of a Dropbox account, iterate through each entry in order and process them as follows to keep your local state in sync:
For each FileMetadata, store the new entry at the given path in your local state. If the required parent folders don't exist yet, create them. If there's already something else at the given path, replace it and remove all its children.
For each FolderMetadata, store the new entry at the given path in your local state. If the required parent folders don't exist yet, create them. If there's already something else at the given path, replace it but leave the children as they are. Check the new entry's FolderSharingInfo.read_only and set all its children's read-only statuses to match.
For each DeletedMetadata, if your local state has something at the given path, remove it and all its children. If there's nothing at the given path, ignore this entry.

URL Structure
https://api.dropboxapi.com/2/files/list_folder
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/list_folder \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/Homework/math\",\"recursive\": false,\"include_media_info\": false,\"include_deleted\": false,\"include_has_explicit_shared_members\": false}"
Parameters
{
    "path": "/Homework/math",
    "recursive": false,
    "include_media_info": false,
    "include_deleted": false,
    "include_has_explicit_shared_members": false
}
ListFolderArg
path String(pattern="(/(.|[\r\n])*)?|(ns:[0-9]+(/.*)?)") The path to the folder you want to see the contents of.
recursive Boolean If true, the list folder operation will be applied recursively to all subfolders and the response will contain contents of all subfolders. The default for this field is False.
include_media_info Boolean If true, FileMetadata.media_info is set for photo and video. The default for this field is False.
include_deleted Boolean If true, the results will include entries for files and folders that used to exist but were deleted. The default for this field is False.
include_has_explicit_shared_members Boolean If true, the results will include a flag for each file indicating whether or not that file has any explicit members. The default for this field is False.
Returns
{
    "entries": [
        {
            ".tag": "file",
            "name": "Prime_Numbers.txt",
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "client_modified": "2015-05-12T15:50:38Z",
            "server_modified": "2015-05-12T15:50:38Z",
            "rev": "a1c10ce0dd78",
            "size": 7212,
            "path_lower": "/homework/math/prime_numbers.txt",
            "path_display": "/Homework/math/Prime_Numbers.txt",
            "sharing_info": {
                "read_only": true,
                "parent_shared_folder_id": "84528192421",
                "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
            },
            "property_groups": [
                {
                    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                    "fields": [
                        {
                            "name": "Security Policy",
                            "value": "Confidential"
                        }
                    ]
                }
            ],
            "has_explicit_shared_members": false
        },
        {
            ".tag": "folder",
            "name": "math",
            "id": "id:a4ayc_80_OEAAAAAAAAAXz",
            "path_lower": "/homework/math",
            "path_display": "/Homework/math",
            "sharing_info": {
                "read_only": false,
                "parent_shared_folder_id": "84528192421",
                "traverse_only": false,
                "no_access": false
            },
            "property_groups": [
                {
                    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                    "fields": [
                        {
                            "name": "Security Policy",
                            "value": "Confidential"
                        }
                    ]
                }
            ]
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
ListFolderResult
entries List of (Metadata) The files and (direct) subfolders in the folder.
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
cursor String(min_length=1) Pass the cursor into list_folder/continue to see what's changed in the folder since your previous query.
has_more Boolean If true, then there are more entries available. Pass the cursor to list_folder/continue to retrieve the rest.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFolderError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.

/list_folder/continue

Description

Once a cursor has been retrieved from list_folder, use this to paginate through all files and retrieve updates to the folder, following the same rules as documented for list_folder.

URL Structure
https://api.dropboxapi.com/2/files/list_folder/continue
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/list_folder/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFolderContinueArg
cursor String(min_length=1) The cursor returned by your last call to list_folder or list_folder/continue.
Returns
{
    "entries": [
        {
            ".tag": "file",
            "name": "Prime_Numbers.txt",
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "client_modified": "2015-05-12T15:50:38Z",
            "server_modified": "2015-05-12T15:50:38Z",
            "rev": "a1c10ce0dd78",
            "size": 7212,
            "path_lower": "/homework/math/prime_numbers.txt",
            "path_display": "/Homework/math/Prime_Numbers.txt",
            "sharing_info": {
                "read_only": true,
                "parent_shared_folder_id": "84528192421",
                "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
            },
            "property_groups": [
                {
                    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                    "fields": [
                        {
                            "name": "Security Policy",
                            "value": "Confidential"
                        }
                    ]
                }
            ],
            "has_explicit_shared_members": false
        },
        {
            ".tag": "folder",
            "name": "math",
            "id": "id:a4ayc_80_OEAAAAAAAAAXz",
            "path_lower": "/homework/math",
            "path_display": "/Homework/math",
            "sharing_info": {
                "read_only": false,
                "parent_shared_folder_id": "84528192421",
                "traverse_only": false,
                "no_access": false
            },
            "property_groups": [
                {
                    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                    "fields": [
                        {
                            "name": "Security Policy",
                            "value": "Confidential"
                        }
                    ]
                }
            ]
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
ListFolderResult
entries List of (Metadata) The files and (direct) subfolders in the folder.
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
cursor String(min_length=1) Pass the cursor into list_folder/continue to see what's changed in the folder since your previous query.
has_more Boolean If true, then there are more entries available. Pass the cursor to list_folder/continue to retrieve the rest.
Errors
Example: reset 
{
    "error_summary": "reset/...",
    "error": {
        ".tag": "reset"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFolderContinueError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
reset Void Indicates that the cursor has been invalidated. Call list_folder to obtain a new cursor.

/list_folder/get_latest_cursor

Description

A way to quickly get a cursor for the folder's state. Unlike list_folder, list_folder/get_latest_cursor doesn't return any entries. This endpoint is for app which only needs to know about new files and modifications and doesn't need to know about files that already exist in Dropbox.

URL Structure
https://api.dropboxapi.com/2/files/list_folder/get_latest_cursor
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/list_folder/get_latest_cursor \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/Homework/math\",\"recursive\": false,\"include_media_info\": false,\"include_deleted\": false,\"include_has_explicit_shared_members\": false}"
Parameters
{
    "path": "/Homework/math",
    "recursive": false,
    "include_media_info": false,
    "include_deleted": false,
    "include_has_explicit_shared_members": false
}
ListFolderArg
path String(pattern="(/(.|[\r\n])*)?|(ns:[0-9]+(/.*)?)") The path to the folder you want to see the contents of.
recursive Boolean If true, the list folder operation will be applied recursively to all subfolders and the response will contain contents of all subfolders. The default for this field is False.
include_media_info Boolean If true, FileMetadata.media_info is set for photo and video. The default for this field is False.
include_deleted Boolean If true, the results will include entries for files and folders that used to exist but were deleted. The default for this field is False.
include_has_explicit_shared_members Boolean If true, the results will include a flag for each file indicating whether or not that file has any explicit members. The default for this field is False.
Returns
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFolderGetLatestCursorResult
cursor String(min_length=1) Pass the cursor into list_folder/continue to see what's changed in the folder since your previous query.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFolderError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.

/list_folder/longpoll

Description

A longpoll endpoint to wait for changes on an account. In conjunction with list_folder/continue, this call gives you a low-latency way to monitor an account for file changes. The connection will block until there are changes available or a timeout occurs. This endpoint is useful mostly for client-side apps. If you're looking for server-side notifications, check out our webhooks documentation.

URL Structure
https://notify.dropboxapi.com/2/files/list_folder/longpoll
Authentication
No Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://notify.dropboxapi.com/2/files/list_folder/longpoll \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\",\"timeout\": 30}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "timeout": 30
}
ListFolderLongpollArg
cursor String(min_length=1) A cursor as returned by list_folder or list_folder/continue. Cursors retrieved by setting ListFolderArg.include_media_info to true are not supported.
timeout UInt64 A timeout in seconds. The request will block for at most this length of time, plus up to 90 seconds of random jitter added to avoid the thundering herd problem. Care should be taken when using this parameter, as some network infrastructure does not support long timeouts. The default for this field is 30.
Returns
{
    "changes": true
}
ListFolderLongpollResult
changes Boolean Indicates whether new changes are available. If true, call list_folder/continue to retrieve the changes.
backoff UInt64? If present, backoff for at least this many seconds before calling list_folder/longpoll again. This field is optional.
Errors
Example: reset 
{
    "error_summary": "reset/...",
    "error": {
        ".tag": "reset"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFolderLongpollError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
reset Void Indicates that the cursor has been invalidated. Call list_folder to obtain a new cursor.

/list_revisions

Description

Return revisions of a file.

URL Structure
https://api.dropboxapi.com/2/files/list_revisions
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/list_revisions \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/root/word.docx\",\"limit\": 10}"
Parameters
{
    "path": "/root/word.docx",
    "limit": 10
}
ListRevisionsArg
path String(pattern="/(.|[\r\n])*|id:.*|(ns:[0-9]+(/.*)?)") The path to the file you want to see the revisions of.
limit UInt64 The maximum number of revision entries returned. The default for this field is 10.
Returns
{
    "is_deleted": false,
    "entries": [
        {
            "name": "Prime_Numbers.txt",
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "client_modified": "2015-05-12T15:50:38Z",
            "server_modified": "2015-05-12T15:50:38Z",
            "rev": "a1c10ce0dd78",
            "size": 7212,
            "path_lower": "/homework/math/prime_numbers.txt",
            "path_display": "/Homework/math/Prime_Numbers.txt",
            "sharing_info": {
                "read_only": true,
                "parent_shared_folder_id": "84528192421",
                "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
            },
            "property_groups": [
                {
                    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                    "fields": [
                        {
                            "name": "Security Policy",
                            "value": "Confidential"
                        }
                    ]
                }
            ],
            "has_explicit_shared_members": false
        }
    ]
}
ListRevisionsResult
is_deleted Boolean If the file is deleted.
entries List of (FileMetadata) The revisions for the file. Only non-delete revisions will show up here.
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListRevisionsError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.

/move

Description

Move a file or folder to a different location in the user's Dropbox.
If the source path is a folder all its contents will be moved.

URL Structure
https://api.dropboxapi.com/2/files/move
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/move \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"from_path\": \"/Homework/math\",\"to_path\": \"/Homework/algebra\",\"allow_shared_folder\": false,\"autorename\": false}"
Parameters
{
    "from_path": "/Homework/math",
    "to_path": "/Homework/algebra",
    "allow_shared_folder": false,
    "autorename": false
}
RelocationArg
from_path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to be copied or moved.
to_path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox that is the destination.
allow_shared_folder Boolean If true, copy will copy contents in shared folder, otherwise RelocationError.cant_copy_shared_folder will be returned if from_path contains shared folder. This field is always true for move. The default for this field is False.
autorename Boolean If there's a conflict, have the Dropbox server try to autorename the file to avoid the conflict. The default for this field is False.
Returns
{
    ".tag": "file",
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
{
    ".tag": "folder",
    "name": "math",
    "id": "id:a4ayc_80_OEAAAAAAAAAXz",
    "path_lower": "/homework/math",
    "path_display": "/Homework/math",
    "sharing_info": {
        "read_only": false,
        "parent_shared_folder_id": "84528192421",
        "traverse_only": false,
        "no_access": false
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ]
}
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
Errors
Example: cant_copy_shared_folder 
{
    "error_summary": "cant_copy_shared_folder/...",
    "error": {
        ".tag": "cant_copy_shared_folder"
    }
}
Example: cant_nest_shared_folder 
{
    "error_summary": "cant_nest_shared_folder/...",
    "error": {
        ".tag": "cant_nest_shared_folder"
    }
}
Example: cant_move_folder_into_itself 
{
    "error_summary": "cant_move_folder_into_itself/...",
    "error": {
        ".tag": "cant_move_folder_into_itself"
    }
}
Example: too_many_files 
{
    "error_summary": "too_many_files/...",
    "error": {
        ".tag": "too_many_files"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RelocationError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
from_lookup LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
from_write WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
to WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
cant_copy_shared_folder Void Shared folders can't be copied.
cant_nest_shared_folder Void Your move operation would result in nested shared folders. This is not allowed.
cant_move_folder_into_itself Void You cannot move a folder into itself.
too_many_files Void The operation would involve more than 10,000 files and folders.

/move_batch

Description

Move multiple files or folders to different locations at once in the user's Dropbox.
This route is 'all or nothing', which means if one entry fails, the whole transaction will abort.
This route will return job ID immediately and do the async moving job in background. Please use move_batch/check to check the job status.

URL Structure
https://api.dropboxapi.com/2/files/move_batch
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/move_batch \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"entries\": [{\"from_path\": \"/Homework/math\",\"to_path\": \"/Homework/algebra\"}],\"allow_shared_folder\": false,\"autorename\": false}"
Parameters
{
    "entries": [
        {
            "from_path": "/Homework/math",
            "to_path": "/Homework/algebra"
        }
    ],
    "allow_shared_folder": false,
    "autorename": false
}
RelocationBatchArg
entries List of (RelocationPath) List of entries to be moved or copied. Each entry is RelocationPath.
RelocationPath
from_path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to be copied or moved.
to_path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox that is the destination.
allow_shared_folder Boolean If true, copy_batch will copy contents in shared folder, otherwise RelocationError.cant_copy_shared_folder will be returned if RelocationPath.from_path contains shared folder. This field is always true for move_batch. The default for this field is False.
autorename Boolean If there's a conflict with any file, have the Dropbox server try to autorename that file to avoid the conflict. The default for this field is False.
Returns
Example: complete 
{
    ".tag": "complete",
    "entries": [
        {
            "metadata": {
                ".tag": "file",
                "name": "Prime_Numbers.txt",
                "id": "id:a4ayc_80_OEAAAAAAAAAXw",
                "client_modified": "2015-05-12T15:50:38Z",
                "server_modified": "2015-05-12T15:50:38Z",
                "rev": "a1c10ce0dd78",
                "size": 7212,
                "path_lower": "/homework/math/prime_numbers.txt",
                "path_display": "/Homework/math/Prime_Numbers.txt",
                "sharing_info": {
                    "read_only": true,
                    "parent_shared_folder_id": "84528192421",
                    "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
                },
                "property_groups": [
                    {
                        "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                        "fields": [
                            {
                                "name": "Security Policy",
                                "value": "Confidential"
                            }
                        ]
                    }
                ],
                "has_explicit_shared_members": false
            }
        }
    ]
}
Example: async_job_id 
{
    ".tag": "async_job_id",
    "async_job_id": "34g93hh34h04y384084"
}
Example: other 
{
    ".tag": "other"
}
RelocationBatchLaunch (open union)
Result returned by copy_batch or move_batch that may either launch an asynchronous job or complete synchronously. The value will be one of the following datatypes. New values may be introduced as our API evolves.
async_job_id String(min_length=1) This response indicates that the processing is asynchronous. The string is an id that can be used to obtain the status of the asynchronous job.
complete RelocationBatchResult
RelocationBatchResult
entries List of (RelocationResult)
RelocationResult
metadata Metadata
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
Errors

No errors.

/move_batch/check

Description

Returns the status of an asynchronous job for move_batch. If success, it returns list of results for each entry.

URL Structure
https://api.dropboxapi.com/2/files/move_batch/check
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/move_batch/check \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"async_job_id\": \"34g93hh34h04y384084\"}"
Parameters
{
    "async_job_id": "34g93hh34h04y384084"
}
PollArg
Arguments for methods that poll the status of an asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace.
async_job_id String(min_length=1) Id of the asynchronous job. This is the value of a response returned from the method that launched the job.
Returns
{
    ".tag": "complete",
    "entries": [
        {
            "metadata": {
                ".tag": "file",
                "name": "Prime_Numbers.txt",
                "id": "id:a4ayc_80_OEAAAAAAAAAXw",
                "client_modified": "2015-05-12T15:50:38Z",
                "server_modified": "2015-05-12T15:50:38Z",
                "rev": "a1c10ce0dd78",
                "size": 7212,
                "path_lower": "/homework/math/prime_numbers.txt",
                "path_display": "/Homework/math/Prime_Numbers.txt",
                "sharing_info": {
                    "read_only": true,
                    "parent_shared_folder_id": "84528192421",
                    "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
                },
                "property_groups": [
                    {
                        "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                        "fields": [
                            {
                                "name": "Security Policy",
                                "value": "Confidential"
                            }
                        ]
                    }
                ],
                "has_explicit_shared_members": false
            }
        }
    ]
}
Example: in_progress 
{
    ".tag": "in_progress"
}
RelocationBatchJobStatus (union)
The value will be one of the following datatypes:
in_progress Void The asynchronous job is still in progress.
complete RelocationBatchResult The copy or move batch job has finished.
RelocationBatchResult
entries List of (RelocationResult)
RelocationResult
metadata Metadata
Metadata (datatype with subtypes)
Metadata for a file or folder. This datatype will be one of the following subtypes:
file FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
folder FolderMetadata
FolderMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the folder.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use sharing_info instead. This field is optional.
sharing_info FolderSharingInfo? Set if the folder is contained in a shared folder or is a shared folder mount point. This field is optional.
FolderSharingInfo
Sharing info for a folder which is contained in a shared folder or is a shared folder mount point.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Set if the folder is contained by a shared folder. This field is optional.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? If this folder is a shared folder mount point, the ID of the shared folder mounted at this location. This field is optional.
traverse_only Boolean Specifies that the folder can only be traversed and the user can only see a limited subset of the contents of this folder because they don't have read access to this folder. They do, however, have access to some sub folder. The default for this field is False.
no_access Boolean Specifies that the folder cannot be accessed by the user. The default for this field is False.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
deleted DeletedMetadata
DeletedMetadata
Indicates that there used to be a file or folder at this path, but it no longer exists.
name String The last component of the path (including extension). This never contains a slash.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
failed RelocationBatchError The copy or move batch job has failed with exception.
RelocationBatchError (union)
The value will be one of the following datatypes:
from_lookup LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
from_write WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
to WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
cant_copy_shared_folder Void Shared folders can't be copied.
cant_nest_shared_folder Void Your move operation would result in nested shared folders. This is not allowed.
cant_move_folder_into_itself Void You cannot move a folder into itself.
too_many_files Void The operation would involve more than 10,000 files and folders.
duplicated_or_nested_paths Void There are duplicated/nested paths among RelocationArg.from_path and RelocationArg.to_path.
too_many_write_operations Void There are too many write operations in user's Dropbox. Please retry this request.
Errors
Example: invalid_async_job_id 
{
    "error_summary": "invalid_async_job_id/...",
    "error": {
        ".tag": "invalid_async_job_id"
    }
}
Example: internal_error 
{
    "error_summary": "internal_error/...",
    "error": {
        ".tag": "internal_error"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
PollError (open union)
Error returned by methods for polling the status of asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_async_job_id Void The job ID is invalid.
internal_error Void Something went wrong with the job on Dropbox's end. You'll need to verify that the action you were taking succeeded, and if not, try again. This should happen very rarely.

/permanently_delete

Description

Permanently delete the file or folder at a given path (see https://www.dropbox.com/en/help/40).
Note: This endpoint is only available for Dropbox Business apps.

URL Structure
https://api.dropboxapi.com/2/files/permanently_delete
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/permanently_delete \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/Homework/math/Prime_Numbers.txt\"}"
Parameters
{
    "path": "/Homework/math/Prime_Numbers.txt"
}
DeleteArg
path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to delete.
Returns

No return values.

Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
DeleteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path_lookup LookupError
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
path_write WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.

/restore

Description

Restore a file to a specific revision.

URL Structure
https://api.dropboxapi.com/2/files/restore
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/restore \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/root/word.docx\",\"rev\": \"a1c10ce0dd78\"}"
Parameters
{
    "path": "/root/word.docx",
    "rev": "a1c10ce0dd78"
}
RestoreArg
path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") The path to the file you want to restore.
rev String(min_length=9, pattern="[0-9a-f]+") The revision to restore for the file.
Returns
{
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
Errors
Example: invalid_revision 
{
    "error_summary": "invalid_revision/...",
    "error": {
        ".tag": "invalid_revision"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RestoreError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path_lookup LookupError An error occurs when downloading metadata for the file.
LookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
not_found Void There is nothing at the given path.
not_file Void We were expecting a file, but the given path refers to something that isn't a file.
not_folder Void We were expecting a folder, but the given path refers to something that isn't a folder.
restricted_content Void The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
path_write WriteError An error occurs when trying to restore the file to that path.
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
invalid_revision Void The revision is invalid. It may point to a different file.

/save_url

Description

Save a specified URL into a file in user's Dropbox. If the given path already exists, the file will be renamed to avoid the conflict (e.g. myfile (1).txt).

URL Structure
https://api.dropboxapi.com/2/files/save_url
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/save_url \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/a.txt\",\"url\": \"http://example.com/a.txt\"}"
Parameters
{
    "path": "/a.txt",
    "url": "http://example.com/a.txt"
}
SaveUrlArg
path String(pattern="/(.|[\r\n])*") The path in Dropbox where the URL will be saved to.
url String The URL to be saved.
Returns
SaveUrlResult (union)
The value will be one of the following datatypes:
async_job_id String(min_length=1) This response indicates that the processing is asynchronous. The string is an id that can be used to obtain the status of the asynchronous job.
complete FileMetadata Metadata of the file where the URL is saved to.
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
Errors
Example: download_failed 
{
    "error_summary": "download_failed/...",
    "error": {
        ".tag": "download_failed"
    }
}
Example: invalid_url 
{
    "error_summary": "invalid_url/...",
    "error": {
        ".tag": "invalid_url"
    }
}
Example: not_found 
{
    "error_summary": "not_found/...",
    "error": {
        ".tag": "not_found"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
SaveUrlError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
download_failed Void Failed downloading the given URL.
invalid_url Void The given URL is invalid.
not_found Void The file where the URL is saved to no longer exists.

/save_url/check_job_status

Description

Check the status of a save_url job.

URL Structure
https://api.dropboxapi.com/2/files/save_url/check_job_status
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/save_url/check_job_status \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"async_job_id\": \"34g93hh34h04y384084\"}"
Parameters
{
    "async_job_id": "34g93hh34h04y384084"
}
PollArg
Arguments for methods that poll the status of an asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace.
async_job_id String(min_length=1) Id of the asynchronous job. This is the value of a response returned from the method that launched the job.
Returns
{
    ".tag": "in_progress"
}
SaveUrlJobStatus (union)
The value will be one of the following datatypes:
in_progress Void The asynchronous job is still in progress.
complete FileMetadata Metadata of the file where the URL is saved to.
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
failed SaveUrlError
SaveUrlError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path WriteError
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
download_failed Void Failed downloading the given URL.
invalid_url Void The given URL is invalid.
not_found Void The file where the URL is saved to no longer exists.
Errors
Example: invalid_async_job_id 
{
    "error_summary": "invalid_async_job_id/...",
    "error": {
        ".tag": "invalid_async_job_id"
    }
}
Example: internal_error 
{
    "error_summary": "internal_error/...",
    "error": {
        ".tag": "internal_error"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
PollError (open union)
Error returned by methods for polling the status of asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_async_job_id Void The job ID is invalid.
internal_error Void Something went wrong with the job on Dropbox's end. You'll need to verify that the action you were taking succeeded, and if not, try again. This should happen very rarely.

/upload

Description

Create a new file with the contents provided in the request.
Do not use this to upload a file larger than 150 MB. Instead, create an upload session with upload_session/start.

URL Structure
https://content.dropboxapi.com/2/files/upload
Authentication
User Authentication
Endpoint format
Content-upload
Example
Get access token for: 
curl -X POST https://content.dropboxapi.com/2/files/upload \
    --header "Authorization: Bearer " \
    --header "Dropbox-API-Arg: {\"path\": \"/Homework/math/Matrices.txt\",\"mode\": \"add\",\"autorename\": true,\"mute\": false}" \
    --header "Content-Type: application/octet-stream" \
    --data-binary @local_file.txt
Parameters
{
    "path": "/Homework/math/Matrices.txt",
    "mode": "add",
    "autorename": true,
    "mute": false
}
Example: update 
{
    "path": "/Homework/math/Matrices.txt",
    "mode": {
        ".tag": "update",
        "update": "a1c10ce0dd78"
    },
    "autorename": false,
    "mute": false
}
CommitInfo
path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to save the file.
mode WriteMode Selects what to do if the file already exists. The default for this union is add.
WriteMode (union)
Your intent when writing a file to some path. This is used to determine what constitutes a conflict and what the autorename strategy is.
In some situations, the conflict behavior is identical: (a) If the target path doesn't contain anything, the file is always written; no conflict. (b) If the target path contains a folder, it's always a conflict. (c) If the target path contains a file with identical contents, nothing gets written; no conflict.
The conflict checking differs in the case where there's a file at the target path with contents different from the contents you're trying to write. The value will be one of the following datatypes:
add Void Do not overwrite an existing file if there is a conflict. The autorename strategy is to append a number to the file name. For example, "document.txt" might become "document (2).txt".
overwrite Void Always overwrite the existing file. The autorename strategy is the same as it is for add.
update String(min_length=9, pattern="[0-9a-f]+") Overwrite if the given "rev" matches the existing file's "rev". The autorename strategy is to append the string "conflicted copy" to the file name. For example, "document.txt" might become "document (conflicted copy).txt" or "document (Panda's conflicted copy).txt".
autorename Boolean If there's a conflict, as determined by mode, have the Dropbox server try to autorename the file to avoid conflict. The default for this field is False.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The value to store as the client_modified timestamp. Dropbox automatically records the time at which the file was written to the Dropbox servers. It can also record an additional timestamp, provided by Dropbox desktop clients, mobile clients, and API apps of when the file was actually created or modified. This field is optional.
mute Boolean Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn't result in a user notification. The default for this field is False.
Returns
{
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
UploadError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
path UploadWriteFailed Unable to save the uploaded contents to a file.
UploadWriteFailed
reason WriteError The reason why the file couldn't be saved.
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
upload_session_id String The upload session ID; this may be used to retry the commit.

/upload_session/append

DEPRECATED BY /upload_session/append_v2
Description

Append more data to an upload session.
A single request should not upload more than 150 MB of file contents.

URL Structure
https://content.dropboxapi.com/2/files/upload_session/append
Authentication
User Authentication
Endpoint format
Content-upload
Example
Get access token for: 
curl -X POST https://content.dropboxapi.com/2/files/upload_session/append \
    --header "Authorization: Bearer " \
    --header "Dropbox-API-Arg: {\"session_id\": \"1234faaf0678bcde\",\"offset\": 0}" \
    --header "Content-Type: application/octet-stream" \
    --data-binary @local_file.txt
Parameters
{
    "session_id": "1234faaf0678bcde",
    "offset": 0
}
UploadSessionCursor
session_id String The upload session ID (returned by upload_session/start).
offset UInt64 The amount of data that has been uploaded so far. We use this to make sure upload data isn't lost or duplicated in the event of a network error.
Returns

No return values.

Errors
Example: not_found 
{
    "error_summary": "not_found/...",
    "error": {
        ".tag": "not_found"
    }
}
Example: closed 
{
    "error_summary": "closed/...",
    "error": {
        ".tag": "closed"
    }
}
Example: not_closed 
{
    "error_summary": "not_closed/...",
    "error": {
        ".tag": "not_closed"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
UploadSessionLookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
not_found Void The upload session id was not found.
incorrect_offset UploadSessionOffsetError The specified offset was incorrect. See the value for the correct offset. This error may occur when a previous request was received and processed successfully but the client did not receive the response, e.g. due to a network error.
UploadSessionOffsetError
correct_offset UInt64 The offset up to which data has been collected.
closed Void You are attempting to append data to an upload session that has alread been closed (i.e. committed).
not_closed Void The session must be closed before calling upload_session/finish_batch.

/upload_session/append_v2

Description

Append more data to an upload session.
When the parameter close is set, this call will close the session.
A single request should not upload more than 150 MB of file contents.

URL Structure
https://content.dropboxapi.com/2/files/upload_session/append_v2
Authentication
User Authentication
Endpoint format
Content-upload
Example
Get access token for: 
curl -X POST https://content.dropboxapi.com/2/files/upload_session/append_v2 \
    --header "Authorization: Bearer " \
    --header "Dropbox-API-Arg: {\"cursor\": {\"session_id\": \"1234faaf0678bcde\",\"offset\": 0},\"close\": false}" \
    --header "Content-Type: application/octet-stream" \
    --data-binary @local_file.txt
Parameters
{
    "cursor": {
        "session_id": "1234faaf0678bcde",
        "offset": 0
    },
    "close": false
}
UploadSessionAppendArg
cursor UploadSessionCursor Contains the upload session ID and the offset.
UploadSessionCursor
session_id String The upload session ID (returned by upload_session/start).
offset UInt64 The amount of data that has been uploaded so far. We use this to make sure upload data isn't lost or duplicated in the event of a network error.
close Boolean If true, the current session will be closed, at which point you won't be able to call upload_session/append_v2 anymore with the current session. The default for this field is False.
Returns

No return values.

Errors
Example: not_found 
{
    "error_summary": "not_found/...",
    "error": {
        ".tag": "not_found"
    }
}
Example: closed 
{
    "error_summary": "closed/...",
    "error": {
        ".tag": "closed"
    }
}
Example: not_closed 
{
    "error_summary": "not_closed/...",
    "error": {
        ".tag": "not_closed"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
UploadSessionLookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
not_found Void The upload session id was not found.
incorrect_offset UploadSessionOffsetError The specified offset was incorrect. See the value for the correct offset. This error may occur when a previous request was received and processed successfully but the client did not receive the response, e.g. due to a network error.
UploadSessionOffsetError
correct_offset UInt64 The offset up to which data has been collected.
closed Void You are attempting to append data to an upload session that has alread been closed (i.e. committed).
not_closed Void The session must be closed before calling upload_session/finish_batch.

/upload_session/finish

Description

Finish an upload session and save the uploaded data to the given file path.
A single request should not upload more than 150 MB of file contents.

URL Structure
https://content.dropboxapi.com/2/files/upload_session/finish
Authentication
User Authentication
Endpoint format
Content-upload
Example
Get access token for: 
curl -X POST https://content.dropboxapi.com/2/files/upload_session/finish \
    --header "Authorization: Bearer " \
    --header "Dropbox-API-Arg: {\"cursor\": {\"session_id\": \"1234faaf0678bcde\",\"offset\": 0},\"commit\": {\"path\": \"/Homework/math/Matrices.txt\",\"mode\": \"add\",\"autorename\": true,\"mute\": false}}" \
    --header "Content-Type: application/octet-stream" \
    --data-binary @local_file.txt
Parameters
{
    "cursor": {
        "session_id": "1234faaf0678bcde",
        "offset": 0
    },
    "commit": {
        "path": "/Homework/math/Matrices.txt",
        "mode": "add",
        "autorename": true,
        "mute": false
    }
}
Example: update 
{
    "cursor": {
        "session_id": "1234faaf0678bcde",
        "offset": 0
    },
    "commit": {
        "path": "/Homework/math/Matrices.txt",
        "mode": {
            ".tag": "update",
            "update": "a1c10ce0dd78"
        },
        "autorename": false,
        "mute": false
    }
}
UploadSessionFinishArg
cursor UploadSessionCursor Contains the upload session ID and the offset.
UploadSessionCursor
session_id String The upload session ID (returned by upload_session/start).
offset UInt64 The amount of data that has been uploaded so far. We use this to make sure upload data isn't lost or duplicated in the event of a network error.
commit CommitInfo Contains the path and other optional modifiers for the commit.
CommitInfo
path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to save the file.
mode WriteMode Selects what to do if the file already exists. The default for this union is add.
WriteMode (union)
Your intent when writing a file to some path. This is used to determine what constitutes a conflict and what the autorename strategy is.
In some situations, the conflict behavior is identical: (a) If the target path doesn't contain anything, the file is always written; no conflict. (b) If the target path contains a folder, it's always a conflict. (c) If the target path contains a file with identical contents, nothing gets written; no conflict.
The conflict checking differs in the case where there's a file at the target path with contents different from the contents you're trying to write. The value will be one of the following datatypes:
add Void Do not overwrite an existing file if there is a conflict. The autorename strategy is to append a number to the file name. For example, "document.txt" might become "document (2).txt".
overwrite Void Always overwrite the existing file. The autorename strategy is the same as it is for add.
update String(min_length=9, pattern="[0-9a-f]+") Overwrite if the given "rev" matches the existing file's "rev". The autorename strategy is to append the string "conflicted copy" to the file name. For example, "document.txt" might become "document (conflicted copy).txt" or "document (Panda's conflicted copy).txt".
autorename Boolean If there's a conflict, as determined by mode, have the Dropbox server try to autorename the file to avoid conflict. The default for this field is False.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The value to store as the client_modified timestamp. Dropbox automatically records the time at which the file was written to the Dropbox servers. It can also record an additional timestamp, provided by Dropbox desktop clients, mobile clients, and API apps of when the file was actually created or modified. This field is optional.
mute Boolean Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn't result in a user notification. The default for this field is False.
Returns
{
    "name": "Prime_Numbers.txt",
    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
    "client_modified": "2015-05-12T15:50:38Z",
    "server_modified": "2015-05-12T15:50:38Z",
    "rev": "a1c10ce0dd78",
    "size": 7212,
    "path_lower": "/homework/math/prime_numbers.txt",
    "path_display": "/Homework/math/Prime_Numbers.txt",
    "sharing_info": {
        "read_only": true,
        "parent_shared_folder_id": "84528192421",
        "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    },
    "property_groups": [
        {
            "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
            "fields": [
                {
                    "name": "Security Policy",
                    "value": "Confidential"
                }
            ]
        }
    ],
    "has_explicit_shared_members": false
}
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
Errors
Example: too_many_shared_folder_targets 
{
    "error_summary": "too_many_shared_folder_targets/...",
    "error": {
        ".tag": "too_many_shared_folder_targets"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
UploadSessionFinishError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
lookup_failed UploadSessionLookupError The session arguments are incorrect; the value explains the reason.
UploadSessionLookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
not_found Void The upload session id was not found.
incorrect_offset UploadSessionOffsetError The specified offset was incorrect. See the value for the correct offset. This error may occur when a previous request was received and processed successfully but the client did not receive the response, e.g. due to a network error.
UploadSessionOffsetError
correct_offset UInt64 The offset up to which data has been collected.
closed Void You are attempting to append data to an upload session that has alread been closed (i.e. committed).
not_closed Void The session must be closed before calling upload_session/finish_batch.
path WriteError Unable to save the uploaded contents to a file.
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
too_many_shared_folder_targets Void The batch request commits files into too many different shared folders. Please limit your batch request to files contained in a single shared folder.

/upload_session/finish_batch

Description

This route helps you commit many files at once into a user's Dropbox. Use upload_session/start and upload_session/append_v2 to upload file contents. We recommend uploading many files in parallel to increase throughput. Once the file contents have been uploaded, rather than calling upload_session/finish, use this route to finish all your upload sessions in a single request.
UploadSessionStartArg.close or UploadSessionAppendArg.close needs to be true for the last upload_session/start or upload_session/append_v2 call.
This route will return a job_id immediately and do the async commit job in background. Use upload_session/finish_batch/check to check the job status.
For the same account, this route should be executed serially. That means you should not start the next job before current job finishes. We allow up to 1000 entries in a single request.

URL Structure
https://api.dropboxapi.com/2/files/upload_session/finish_batch
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/upload_session/finish_batch \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"entries\": [{\"cursor\": {\"session_id\": \"1234faaf0678bcde\",\"offset\": 0},\"commit\": {\"path\": \"/Homework/math/Matrices.txt\",\"mode\": {\".tag\": \"add\"},\"autorename\": true,\"mute\": false}}]}"
Parameters
{
    "entries": [
        {
            "cursor": {
                "session_id": "1234faaf0678bcde",
                "offset": 0
            },
            "commit": {
                "path": "/Homework/math/Matrices.txt",
                "mode": {
                    ".tag": "add"
                },
                "autorename": true,
                "mute": false
            }
        }
    ]
}
UploadSessionFinishBatchArg
entries List of (UploadSessionFinishArg, max_items=1000) Commit information for each file in the batch.
UploadSessionFinishArg
cursor UploadSessionCursor Contains the upload session ID and the offset.
UploadSessionCursor
session_id String The upload session ID (returned by upload_session/start).
offset UInt64 The amount of data that has been uploaded so far. We use this to make sure upload data isn't lost or duplicated in the event of a network error.
commit CommitInfo Contains the path and other optional modifiers for the commit.
CommitInfo
path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") Path in the user's Dropbox to save the file.
mode WriteMode Selects what to do if the file already exists. The default for this union is add.
WriteMode (union)
Your intent when writing a file to some path. This is used to determine what constitutes a conflict and what the autorename strategy is.
In some situations, the conflict behavior is identical: (a) If the target path doesn't contain anything, the file is always written; no conflict. (b) If the target path contains a folder, it's always a conflict. (c) If the target path contains a file with identical contents, nothing gets written; no conflict.
The conflict checking differs in the case where there's a file at the target path with contents different from the contents you're trying to write. The value will be one of the following datatypes:
add Void Do not overwrite an existing file if there is a conflict. The autorename strategy is to append a number to the file name. For example, "document.txt" might become "document (2).txt".
overwrite Void Always overwrite the existing file. The autorename strategy is the same as it is for add.
update String(min_length=9, pattern="[0-9a-f]+") Overwrite if the given "rev" matches the existing file's "rev". The autorename strategy is to append the string "conflicted copy" to the file name. For example, "document.txt" might become "document (conflicted copy).txt" or "document (Panda's conflicted copy).txt".
autorename Boolean If there's a conflict, as determined by mode, have the Dropbox server try to autorename the file to avoid conflict. The default for this field is False.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The value to store as the client_modified timestamp. Dropbox automatically records the time at which the file was written to the Dropbox servers. It can also record an additional timestamp, provided by Dropbox desktop clients, mobile clients, and API apps of when the file was actually created or modified. This field is optional.
mute Boolean Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn't result in a user notification. The default for this field is False.
Returns
Example: complete 
{
    ".tag": "complete",
    "entries": [
        {
            ".tag": "success",
            "name": "Prime_Numbers.txt",
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "client_modified": "2015-05-12T15:50:38Z",
            "server_modified": "2015-05-12T15:50:38Z",
            "rev": "a1c10ce0dd78",
            "size": 7212,
            "path_lower": "/homework/math/prime_numbers.txt",
            "path_display": "/Homework/math/Prime_Numbers.txt",
            "sharing_info": {
                "read_only": true,
                "parent_shared_folder_id": "84528192421",
                "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
            },
            "property_groups": [
                {
                    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                    "fields": [
                        {
                            "name": "Security Policy",
                            "value": "Confidential"
                        }
                    ]
                }
            ],
            "has_explicit_shared_members": false
        }
    ]
}
Example: async_job_id 
{
    ".tag": "async_job_id",
    "async_job_id": "34g93hh34h04y384084"
}
Example: other 
{
    ".tag": "other"
}
UploadSessionFinishBatchLaunch (open union)
Result returned by upload_session/finish_batch that may either launch an asynchronous job or complete synchronously. The value will be one of the following datatypes. New values may be introduced as our API evolves.
async_job_id String(min_length=1) This response indicates that the processing is asynchronous. The string is an id that can be used to obtain the status of the asynchronous job.
complete UploadSessionFinishBatchResult
UploadSessionFinishBatchResult
entries List of (UploadSessionFinishBatchResultEntry) Commit result for each file in the batch.
UploadSessionFinishBatchResultEntry (union)
The value will be one of the following datatypes:
success FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
failure UploadSessionFinishError
UploadSessionFinishError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
lookup_failed UploadSessionLookupError The session arguments are incorrect; the value explains the reason.
UploadSessionLookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
not_found Void The upload session id was not found.
incorrect_offset UploadSessionOffsetError The specified offset was incorrect. See the value for the correct offset. This error may occur when a previous request was received and processed successfully but the client did not receive the response, e.g. due to a network error.
UploadSessionOffsetError
correct_offset UInt64 The offset up to which data has been collected.
closed Void You are attempting to append data to an upload session that has alread been closed (i.e. committed).
not_closed Void The session must be closed before calling upload_session/finish_batch.
path WriteError Unable to save the uploaded contents to a file.
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
too_many_shared_folder_targets Void The batch request commits files into too many different shared folders. Please limit your batch request to files contained in a single shared folder.
Errors

No errors.

/upload_session/finish_batch/check

Description

Returns the status of an asynchronous job for upload_session/finish_batch. If success, it returns list of result for each entry.

URL Structure
https://api.dropboxapi.com/2/files/upload_session/finish_batch/check
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/files/upload_session/finish_batch/check \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"async_job_id\": \"34g93hh34h04y384084\"}"
Parameters
{
    "async_job_id": "34g93hh34h04y384084"
}
PollArg
Arguments for methods that poll the status of an asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace.
async_job_id String(min_length=1) Id of the asynchronous job. This is the value of a response returned from the method that launched the job.
Returns
{
    ".tag": "complete",
    "entries": [
        {
            ".tag": "success",
            "name": "Prime_Numbers.txt",
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "client_modified": "2015-05-12T15:50:38Z",
            "server_modified": "2015-05-12T15:50:38Z",
            "rev": "a1c10ce0dd78",
            "size": 7212,
            "path_lower": "/homework/math/prime_numbers.txt",
            "path_display": "/Homework/math/Prime_Numbers.txt",
            "sharing_info": {
                "read_only": true,
                "parent_shared_folder_id": "84528192421",
                "modified_by": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
            },
            "property_groups": [
                {
                    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
                    "fields": [
                        {
                            "name": "Security Policy",
                            "value": "Confidential"
                        }
                    ]
                }
            ],
            "has_explicit_shared_members": false
        }
    ]
}
Example: in_progress 
{
    ".tag": "in_progress"
}
UploadSessionFinishBatchJobStatus (union)
The value will be one of the following datatypes:
in_progress Void The asynchronous job is still in progress.
complete UploadSessionFinishBatchResult The upload_session/finish_batch has finished.
UploadSessionFinishBatchResult
entries List of (UploadSessionFinishBatchResultEntry) Commit result for each file in the batch.
UploadSessionFinishBatchResultEntry (union)
The value will be one of the following datatypes:
success FileMetadata
FileMetadata
name String The last component of the path (including extension). This never contains a slash.
id String(min_length=1) A unique identifier for the file.
client_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") For files, this is the modification time set by the desktop client when the file was added to Dropbox. Since this time is not verified (the Dropbox server stores whatever the desktop client sends up), this should only be used for display purposes (such as sorting) and not, for example, to determine if a file has changed or not.
server_modified Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The last time the file was modified on Dropbox.
rev String(min_length=9, pattern="[0-9a-f]+") A unique identifier for the current revision of a file. This field is the same rev as elsewhere in the API and can be used to detect changes and avoid conflicts.
size UInt64 The file size in bytes.
path_lower String? The lowercased full path in the user's Dropbox. This always starts with a slash. This field will be null if the file or folder is not mounted. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1, and at least the last path component will have the correct casing. Changes to only the casing of paths won't be returned by list_folder/continue. This field will be null if the file or folder is not mounted. This field is optional.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? Deprecated. Please use FileSharingInfo.parent_shared_folder_id or FolderSharingInfo.parent_shared_folder_id instead. This field is optional.
media_info MediaInfo? Additional information if the file is a photo or video. This field is optional.
MediaInfo (union)
The value will be one of the following datatypes:
pending Void Indicate the photo/video is still under processing and metadata is not available yet.
metadata MediaMetadata The metadata for the photo/video.
MediaMetadata (datatype with subtypes)
Metadata for a photo or video. This datatype will be one of the following subtypes:
photo PhotoMetadata
PhotoMetadata
Metadata for a photo.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
video VideoMetadata
VideoMetadata
Metadata for a video.
dimensions Dimensions? Dimension of the photo/video. This field is optional.
Dimensions
Dimensions for a photo or video.
height UInt64 Height of the photo/video.
width UInt64 Width of the photo/video.
location GpsCoordinates? The GPS coordinate of the photo/video. This field is optional.
GpsCoordinates
GPS coordinates for a photo or video.
latitude Float64 Latitude of the GPS coordinates.
longitude Float64 Longitude of the GPS coordinates.
time_taken Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The timestamp when the photo/video is taken. This field is optional.
duration UInt64? The duration of the video in milliseconds. This field is optional.
sharing_info FileSharingInfo? Set if this file is contained in a shared folder. This field is optional.
FileSharingInfo
Sharing info for a file which is contained by a shared folder.
read_only Boolean True if the file or folder is inside a read-only shared folder.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") ID of shared folder that holds this file.
modified_by String(min_length=40, max_length=40)? The last user who modified the file. This field will be null if the user's account has been deleted. This field is optional.
property_groups List of (PropertyGroup)? Additional information if the file has custom properties with the property template specified. This field is optional.
PropertyGroup
Collection of custom properties in filled property templates. This datatype comes from an imported namespace originally defined in the properties namespace.
template_id String(min_length=1, pattern="(/|ptid:).*") A unique identifier for a property template type.
fields List of (PropertyField) This is a list of custom properties associated with a file. There can be up to 32 properties for a template.
PropertyField
This datatype comes from an imported namespace originally defined in the properties namespace.
name String This is the name or key of a custom property in a property template. File property names can be up to 256 bytes.
value String Value of a custom property attached to a file. Values can be up to 1024 bytes.
has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional.
failure UploadSessionFinishError
UploadSessionFinishError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
lookup_failed UploadSessionLookupError The session arguments are incorrect; the value explains the reason.
UploadSessionLookupError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
not_found Void The upload session id was not found.
incorrect_offset UploadSessionOffsetError The specified offset was incorrect. See the value for the correct offset. This error may occur when a previous request was received and processed successfully but the client did not receive the response, e.g. due to a network error.
UploadSessionOffsetError
correct_offset UInt64 The offset up to which data has been collected.
closed Void You are attempting to append data to an upload session that has alread been closed (i.e. committed).
not_closed Void The session must be closed before calling upload_session/finish_batch.
path WriteError Unable to save the uploaded contents to a file.
WriteError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? This field is optional.
conflict WriteConflictError Couldn't write to the target path because there was something in the way.
WriteConflictError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
file Void There's a file in the way.
folder Void There's a folder in the way.
file_ancestor Void There's a file at an ancestor path, so we couldn't create the required parent folders.
no_write_permission Void The user doesn't have permissions to write to the target location.
insufficient_space Void The user doesn't have enough available space (bytes) to write more data.
disallowed_name Void Dropbox will not save the file or folder because of its name.
too_many_shared_folder_targets Void The batch request commits files into too many different shared folders. Please limit your batch request to files contained in a single shared folder.
Errors
Example: invalid_async_job_id 
{
    "error_summary": "invalid_async_job_id/...",
    "error": {
        ".tag": "invalid_async_job_id"
    }
}
Example: internal_error 
{
    "error_summary": "internal_error/...",
    "error": {
        ".tag": "internal_error"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
PollError (open union)
Error returned by methods for polling the status of asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_async_job_id Void The job ID is invalid.
internal_error Void Something went wrong with the job on Dropbox's end. You'll need to verify that the action you were taking succeeded, and if not, try again. This should happen very rarely.

/upload_session/start

Description

Upload sessions allow you to upload a single file in one or more requests, for example where the size of the file is greater than 150 MB. This call starts a new upload session with the given data. You can then use upload_session/append_v2 to add more data and upload_session/finish to save all the data to a file in Dropbox.
A single request should not upload more than 150 MB of file contents.

URL Structure
https://content.dropboxapi.com/2/files/upload_session/start
Authentication
User Authentication
Endpoint format
Content-upload
Example
Get access token for: 
curl -X POST https://content.dropboxapi.com/2/files/upload_session/start \
    --header "Authorization: Bearer " \
    --header "Dropbox-API-Arg: {\"close\": false}" \
    --header "Content-Type: application/octet-stream" \
    --data-binary @local_file.txt
Parameters
{
    "close": false
}
UploadSessionStartArg
close Boolean If true, the current session will be closed, at which point you won't be able to call upload_session/append_v2 anymore with the current session. The default for this field is False.
Returns
{
    "session_id": "1234faaf0678bcde"
}
UploadSessionStartResult
session_id String A unique identifier for the upload session. Pass this to upload_session/append_v2 and upload_session/finish.
Errors

No errors.

paper

This namespace contains endpoints and data types for managing docs and folders in Dropbox Paper.

/docs/archive

Description

Marks the given Paper doc as deleted. This operation is non-destructive and the doc can be revived by the owner.

Note: This action can be performed only by the doc owner.

URL Structure
https://api.dropboxapi.com/2/paper/docs/archive
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/archive \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\"}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q"
}
RefPaperDoc
doc_id String
Returns

No return values.

Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

/docs/download

Description

Exports and downloads Paper doc either as HTML or markdown.

URL Structure
https://api.dropboxapi.com/2/paper/docs/download
Authentication
User Authentication
Endpoint format
Content-download
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/download \
    --header "Authorization: Bearer " \
    --header "Dropbox-API-Arg: {\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\",\"export_format\": \"markdown\"}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q",
    "export_format": "markdown"
}
PaperDocExport
doc_id String
export_format ExportFormat
ExportFormat (open union)
The desired export format of the Paper doc. The value will be one of the following datatypes. New values may be introduced as our API evolves.
html Void The HTML export format.
markdown Void The markdown export format.
Returns
{
    "owner": "james@example.com",
    "title": "Week one retention",
    "revision": 456736745,
    "mime_type": "text/x-markdown"
}
PaperDocExportResult
owner String The Paper doc owner's email.
title String The Paper doc title.
revision Int64 The Paper doc revision. Simply an ever increasing number.
mime_type String MIME type of the export. This corresponds to ExportFormat specified in the request.
Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

/docs/folder_users/list

Description

Lists the users who are explicitly invited to the Paper folder in which the Paper doc is contained. For private folders all users (including owner) shared on the folder are listed and for team folders all non-team users shared on the folder are returned.

URL Structure
https://api.dropboxapi.com/2/paper/docs/folder_users/list
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/folder_users/list \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\",\"limit\": 100}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q",
    "limit": 100
}
ListUsersOnFolderArgs
doc_id String
limit Int32 Size limit per batch. The maximum number of users that can be retrieved per batch is 1000. Higher value results in invalid arguments error. The default for this field is 1000.
Returns
{
    "invitees": [
        {
            ".tag": "email",
            "email": "jessica@example.com"
        }
    ],
    "users": [
        {
            "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
            "same_team": true,
            "team_member_id": "dbmid:abcd1234"
        }
    ],
    "cursor": {
        "value": "zHZvTPBnXilGgm1AmDgVyZ10zf7qb0qznd5sAVQbbIvoteSnWLjUdLU7aR25hb",
        "expiration": "2016-08-07T14:56:15Z"
    },
    "has_more": false
}
ListUsersOnFolderResponse
invitees List of (InviteeInfo) List of email addresses that are invited on the Paper folder.
InviteeInfo (open union)
Information about the recipient of a shared content invitation. This datatype comes from an imported namespace originally defined in the sharing namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of invited user.
users List of (UserInfo) List of users that are invited on the Paper folder.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information. This datatype comes from an imported namespace originally defined in the sharing namespace.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
cursor Cursor Pass the cursor into docs/folder_users/list/continue to paginate through all users. The cursor preserves all properties as specified in the original call to docs/folder_users/list.
Cursor
value String The actual cursor value.
expiration Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Expiration time of value.
Some cursors might have expiration time assigned. This is a UTC value after which the cursor is no longer valid and the API starts returning an error. If cursor expires a new one needs to be obtained and pagination needs to be restarted. Some cursors might be short-lived some cursors might be long-lived.
This really depends on the sorting type and order, e.g.:
1. on one hand, listing docs created by the user, sorted by the created time ascending will have undefinite expiration because the results cannot change while the iteration is happening. This cursor would be suitable for long term polling.
2. on the other hand, listing docs sorted by the last modified time will have a very short expiration as docs do get modified very often and the modified time can be changed while the iteration is happening thus altering the results. This field is optional.
has_more Boolean Will be set to True if a subsequent call with the provided cursor to docs/folder_users/list/continue returns immediately with some results. If set to False please allow some delay before making another call to docs/folder_users/list/continue.
Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

/docs/folder_users/list/continue

Description

Once a cursor has been retrieved from docs/folder_users/list, use this to paginate through all users on the Paper folder.

URL Structure
https://api.dropboxapi.com/2/paper/docs/folder_users/list/continue
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/folder_users/list/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\",\"cursor\": \"U60b6BxT43ySd5sAVQbbIvoteSnWLjUdLU7aR25hbt3ySd5sAVQbbIvoteSnWLjUd\"}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q",
    "cursor": "U60b6BxT43ySd5sAVQbbIvoteSnWLjUdLU7aR25hbt3ySd5sAVQbbIvoteSnWLjUd"
}
ListUsersOnFolderContinueArgs
doc_id String
cursor String The cursor obtained from docs/folder_users/list or docs/folder_users/list/continue. Allows for pagination.
Returns
{
    "invitees": [
        {
            ".tag": "email",
            "email": "jessica@example.com"
        }
    ],
    "users": [
        {
            "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
            "same_team": true,
            "team_member_id": "dbmid:abcd1234"
        }
    ],
    "cursor": {
        "value": "zHZvTPBnXilGgm1AmDgVyZ10zf7qb0qznd5sAVQbbIvoteSnWLjUdLU7aR25hb",
        "expiration": "2016-08-07T14:56:15Z"
    },
    "has_more": false
}
ListUsersOnFolderResponse
invitees List of (InviteeInfo) List of email addresses that are invited on the Paper folder.
InviteeInfo (open union)
Information about the recipient of a shared content invitation. This datatype comes from an imported namespace originally defined in the sharing namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of invited user.
users List of (UserInfo) List of users that are invited on the Paper folder.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information. This datatype comes from an imported namespace originally defined in the sharing namespace.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
cursor Cursor Pass the cursor into docs/folder_users/list/continue to paginate through all users. The cursor preserves all properties as specified in the original call to docs/folder_users/list.
Cursor
value String The actual cursor value.
expiration Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Expiration time of value.
Some cursors might have expiration time assigned. This is a UTC value after which the cursor is no longer valid and the API starts returning an error. If cursor expires a new one needs to be obtained and pagination needs to be restarted. Some cursors might be short-lived some cursors might be long-lived.
This really depends on the sorting type and order, e.g.:
1. on one hand, listing docs created by the user, sorted by the created time ascending will have undefinite expiration because the results cannot change while the iteration is happening. This cursor would be suitable for long term polling.
2. on the other hand, listing docs sorted by the last modified time will have a very short expiration as docs do get modified very often and the modified time can be changed while the iteration is happening thus altering the results. This field is optional.
has_more Boolean Will be set to True if a subsequent call with the provided cursor to docs/folder_users/list/continue returns immediately with some results. If set to False please allow some delay before making another call to docs/folder_users/list/continue.
Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
ListUsersCursorError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.
cursor_error PaperApiCursorError
PaperApiCursorError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
expired_cursor Void The provided cursor is expired.
invalid_cursor Void The provided cursor is invalid.
wrong_user_in_cursor Void The provided cursor contains invalid user.
reset Void Indicates that the cursor has been invalidated. Call the corresponding non-continue endpoint to obtain a new cursor.

/docs/get_folder_info

Description

Retrieves folder information for the given Paper doc. This includes:
- folder sharing policy; permissions for subfolders are set by the top-level folder.
- full 'filepath', i.e. the list of folders (both folderId and folderName) from the root folder to the folder directly containing the Paper doc.

Note: If the Paper doc is not in any folder (aka unfiled) the response will be empty.

URL Structure
https://api.dropboxapi.com/2/paper/docs/get_folder_info
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/get_folder_info \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\"}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q"
}
RefPaperDoc
doc_id String
Returns
{
    "folder_sharing_policy_type": {
        ".tag": "team"
    },
    "folders": [
        {
            "id": "e.gGYT6HSafpMej9bUv306oGm60vrHiCHgEFnzziioPGCvHf",
            "name": "Design docs"
        }
    ]
}
FoldersContainingPaperDoc
Metadata about Paper folders containing the specififed Paper doc.
folder_sharing_policy_type FolderSharingPolicyType? The sharing policy of the folder containing the Paper doc. This field is optional.
FolderSharingPolicyType (union)
The sharing policy of a Paper folder.

Note: The sharing policy of subfolders is inherited from the root folder. The value will be one of the following datatypes:
team Void Everyone in your team and anyone directly invited can access this folder.
invite_only Void Only people directly invited can access this folder.
folders List of (Folder)? The folder path. If present the first folder is the root folder. This field is optional.
Folder
Data structure representing a Paper folder.
id String Paper folder id. This id uniquely identifies the folder.
name String Paper folder name.
Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

/docs/list

Description

Return the list of all Paper docs according to the argument specifications. To iterate over through the full pagination, pass the cursor to docs/list/continue.

URL Structure
https://api.dropboxapi.com/2/paper/docs/list
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/list \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"filter_by\": \"docs_created\",\"sort_by\": \"modified\",\"sort_order\": \"descending\",\"limit\": 100}"
Parameters
{
    "filter_by": "docs_created",
    "sort_by": "modified",
    "sort_order": "descending",
    "limit": 100
}
ListPaperDocsArgs
filter_by ListPaperDocsFilterBy Allows user to specify how the Paper docs should be filtered. The default for this union is docs_accessed.
ListPaperDocsFilterBy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
docs_accessed Void Fetches all Paper doc ids that the user has ever accessed.
docs_created Void Fetches only the Paper doc ids that the user has created.
sort_by ListPaperDocsSortBy Allows user to specify how the Paper docs should be sorted. The default for this union is accessed.
ListPaperDocsSortBy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
accessed Void Sorts the Paper docs by the time they were last accessed.
modified Void Sorts the Paper docs by the time they were last modified.
created Void Sorts the Paper docs by the creation time.
sort_order ListPaperDocsSortOrder Allows user to specify the sort order of the result. The default for this union is ascending.
ListPaperDocsSortOrder (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
ascending Void Sorts the search result in ascending order.
descending Void Sorts the search result in descending order.
limit Int32 Size limit per batch. The maximum number of docs that can be retrieved per batch is 1000. Higher value results in invalid arguments error. The default for this field is 1000.
Returns
{
    "doc_ids": [
        "zO1E7coc54sE8IuMdUoxz",
        "mm1AmDgVyZ10zf7qb0qzn",
        "dByYHZvTPBnXilGgyc5mm"
    ],
    "cursor": {
        "value": "zHZvTPBnXilGgm1AmDgVyZ10zf7qb0qznd5sAVQbbIvoteSnWLjUdLU7aR25hb",
        "expiration": "2016-08-07T14:56:15Z"
    },
    "has_more": true
}
ListPaperDocsResponse
doc_ids List of (String) The list of Paper doc ids that can be used to access the given Paper docs or supplied to other API methods. The list is sorted in the order specified by the initial call to docs/list.
cursor Cursor Pass the cursor into docs/list/continue to paginate through all files. The cursor preserves all properties as specified in the original call to docs/list.
Cursor
value String The actual cursor value.
expiration Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Expiration time of value.
Some cursors might have expiration time assigned. This is a UTC value after which the cursor is no longer valid and the API starts returning an error. If cursor expires a new one needs to be obtained and pagination needs to be restarted. Some cursors might be short-lived some cursors might be long-lived.
This really depends on the sorting type and order, e.g.:
1. on one hand, listing docs created by the user, sorted by the created time ascending will have undefinite expiration because the results cannot change while the iteration is happening. This cursor would be suitable for long term polling.
2. on the other hand, listing docs sorted by the last modified time will have a very short expiration as docs do get modified very often and the modified time can be changed while the iteration is happening thus altering the results. This field is optional.
has_more Boolean Will be set to True if a subsequent call with the provided cursor to docs/list/continue returns immediately with some results. If set to False please allow some delay before making another call to docs/list/continue.
Errors

No errors.

/docs/list/continue

Description

Once a cursor has been retrieved from docs/list, use this to paginate through all Paper doc.

URL Structure
https://api.dropboxapi.com/2/paper/docs/list/continue
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/list/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"U60b6BxT43ySd5sAVQbbIvoteSnWLjUdLU7aR25hbt3ySd5sAVQbbIvoteSnWLjUd\"}"
Parameters
{
    "cursor": "U60b6BxT43ySd5sAVQbbIvoteSnWLjUdLU7aR25hbt3ySd5sAVQbbIvoteSnWLjUd"
}
ListPaperDocsContinueArgs
cursor String The cursor obtained from docs/list or docs/list/continue. Allows for pagination.
Returns
{
    "doc_ids": [
        "zO1E7coc54sE8IuMdUoxz",
        "mm1AmDgVyZ10zf7qb0qzn",
        "dByYHZvTPBnXilGgyc5mm"
    ],
    "cursor": {
        "value": "zHZvTPBnXilGgm1AmDgVyZ10zf7qb0qznd5sAVQbbIvoteSnWLjUdLU7aR25hb",
        "expiration": "2016-08-07T14:56:15Z"
    },
    "has_more": true
}
ListPaperDocsResponse
doc_ids List of (String) The list of Paper doc ids that can be used to access the given Paper docs or supplied to other API methods. The list is sorted in the order specified by the initial call to docs/list.
cursor Cursor Pass the cursor into docs/list/continue to paginate through all files. The cursor preserves all properties as specified in the original call to docs/list.
Cursor
value String The actual cursor value.
expiration Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Expiration time of value.
Some cursors might have expiration time assigned. This is a UTC value after which the cursor is no longer valid and the API starts returning an error. If cursor expires a new one needs to be obtained and pagination needs to be restarted. Some cursors might be short-lived some cursors might be long-lived.
This really depends on the sorting type and order, e.g.:
1. on one hand, listing docs created by the user, sorted by the created time ascending will have undefinite expiration because the results cannot change while the iteration is happening. This cursor would be suitable for long term polling.
2. on the other hand, listing docs sorted by the last modified time will have a very short expiration as docs do get modified very often and the modified time can be changed while the iteration is happening thus altering the results. This field is optional.
has_more Boolean Will be set to True if a subsequent call with the provided cursor to docs/list/continue returns immediately with some results. If set to False please allow some delay before making another call to docs/list/continue.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListDocsCursorError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
cursor_error PaperApiCursorError
PaperApiCursorError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
expired_cursor Void The provided cursor is expired.
invalid_cursor Void The provided cursor is invalid.
wrong_user_in_cursor Void The provided cursor contains invalid user.
reset Void Indicates that the cursor has been invalidated. Call the corresponding non-continue endpoint to obtain a new cursor.

/docs/permanently_delete

Description

Permanently deletes the given Paper doc. This operation is final as the doc cannot be recovered.

Note: This action can be performed only by the doc owner.

URL Structure
https://api.dropboxapi.com/2/paper/docs/permanently_delete
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/permanently_delete \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\"}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q"
}
RefPaperDoc
doc_id String
Returns

No return values.

Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

/docs/sharing_policy/get

Description

Gets the default sharing policy for the given Paper doc.

URL Structure
https://api.dropboxapi.com/2/paper/docs/sharing_policy/get
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/sharing_policy/get \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\"}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q"
}
RefPaperDoc
doc_id String
Returns
{
    "public_sharing_policy": {
        ".tag": "people_with_link_can_edit"
    },
    "team_sharing_policy": {
        ".tag": "people_with_link_can_edit"
    }
}
SharingPolicy
Sharing policy of Paper doc.
public_sharing_policy SharingPublicPolicyType? This value applies to the non-team members. This field is optional.
SharingPublicPolicyType (union)
The value will be one of the following datatypes:
people_with_link_can_edit Void Users who have a link to this doc can edit it.
people_with_link_can_view_and_comment Void Users who have a link to this doc can view and comment on it.
invite_only Void Users must be explicitly invited to this doc.
disabled Void Value used to indicate that doc sharing is enabled only within team.
team_sharing_policy SharingTeamPolicyType? This value applies to the team members only. The value is null for all personal accounts. This field is optional.
SharingTeamPolicyType (union)
The sharing policy type of the Paper doc. The value will be one of the following datatypes:
people_with_link_can_edit Void Users who have a link to this doc can edit it.
people_with_link_can_view_and_comment Void Users who have a link to this doc can view and comment on it.
invite_only Void Users must be explicitly invited to this doc.
Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

/docs/sharing_policy/set

Description

Sets the default sharing policy for the given Paper doc. The default 'team_sharing_policy' can be changed only by teams, omit this field for personal accounts.

Note: 'public_sharing_policy' cannot be set to the value 'disabled' because this setting can be changed only via the team admin console.

URL Structure
https://api.dropboxapi.com/2/paper/docs/sharing_policy/set
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/sharing_policy/set \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\",\"sharing_policy\": {\"public_sharing_policy\": \"people_with_link_can_edit\",\"team_sharing_policy\": \"people_with_link_can_edit\"}}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q",
    "sharing_policy": {
        "public_sharing_policy": "people_with_link_can_edit",
        "team_sharing_policy": "people_with_link_can_edit"
    }
}
PaperDocSharingPolicy
doc_id String
sharing_policy SharingPolicy The default sharing policy to be set for the Paper doc.
SharingPolicy
Sharing policy of Paper doc.
public_sharing_policy SharingPublicPolicyType? This value applies to the non-team members. This field is optional.
SharingPublicPolicyType (union)
The value will be one of the following datatypes:
people_with_link_can_edit Void Users who have a link to this doc can edit it.
people_with_link_can_view_and_comment Void Users who have a link to this doc can view and comment on it.
invite_only Void Users must be explicitly invited to this doc.
disabled Void Value used to indicate that doc sharing is enabled only within team.
team_sharing_policy SharingTeamPolicyType? This value applies to the team members only. The value is null for all personal accounts. This field is optional.
SharingTeamPolicyType (union)
The sharing policy type of the Paper doc. The value will be one of the following datatypes:
people_with_link_can_edit Void Users who have a link to this doc can edit it.
people_with_link_can_view_and_comment Void Users who have a link to this doc can view and comment on it.
invite_only Void Users must be explicitly invited to this doc.
Returns

No return values.

Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

/docs/users/add

Description

Allows an owner or editor to add users to a Paper doc or change their permissions using their email or Dropbox account id.

Note: The Doc owner's permissions cannot be changed.

URL Structure
https://api.dropboxapi.com/2/paper/docs/users/add
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/users/add \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\",\"members\": [{\"member\": {\".tag\": \"email\",\"email\": \"justin@example.com\"},\"permission_level\": {\".tag\": \"view_and_comment\"}}],\"custom_message\": \"Welcome to Paper.\",\"quiet\": false}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q",
    "members": [
        {
            "member": {
                ".tag": "email",
                "email": "justin@example.com"
            },
            "permission_level": {
                ".tag": "view_and_comment"
            }
        }
    ],
    "custom_message": "Welcome to Paper.",
    "quiet": false
}
AddPaperDocUser
doc_id String
members List of (AddMember, max_items=20) User which should be added to the Paper doc. Specify only email or Dropbox account id.
AddMember
member MemberSelector User which should be added to the Paper doc. Specify only email or Dropbox account id.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. This datatype comes from an imported namespace originally defined in the sharing namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
permission_level PaperDocPermissionLevel Permission for the user. The default for this union is edit.
PaperDocPermissionLevel (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit Void User will be granted edit permissions.
view_and_comment Void User will be granted view and comment permissions.
custom_message String? A personal message that will be emailed to each successfully added member. This field is optional.
quiet Boolean Clients should set this to true if no email shall be sent to added users. The default for this field is False.
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
AddPaperDocUserMemberResult
Per-member result for docs/users/add.
member MemberSelector One of specified input members.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. This datatype comes from an imported namespace originally defined in the sharing namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
result AddPaperDocUserResult The outcome of the action on this member.
AddPaperDocUserResult (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
success Void User was successfully added to the Paper doc.
unknown_error Void Something unexpected happened when trying to add the user to the Paper doc.
sharing_outside_team_disabled Void The Paper doc can be shared only with team members.
daily_limit_reached Void The daily limit of how many users can be added to the Paper doc was reached.
user_is_owner Void Owner's permissions cannot be changed.
failed_user_data_retrieval Void User data could not be retrieved. Clients should retry.
permission_already_granted Void This user already has the correct permission to the Paper doc.
Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

/docs/users/list

Description

Lists all users who visited the Paper doc or users with explicit access. This call excludes users who have been removed. The list is sorted by the date of the visit or the share date.
The list will include both users, the explicitly shared ones as well as those who came in using the Paper url link.

URL Structure
https://api.dropboxapi.com/2/paper/docs/users/list
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/users/list \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\",\"limit\": 100,\"filter_by\": \"shared\"}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q",
    "limit": 100,
    "filter_by": "shared"
}
ListUsersOnPaperDocArgs
doc_id String
limit Int32 Size limit per batch. The maximum number of users that can be retrieved per batch is 1000. Higher value results in invalid arguments error. The default for this field is 1000.
filter_by UserOnPaperDocFilter Specify this attribute if you want to obtain users that have already accessed the Paper doc. The default for this union is shared.
UserOnPaperDocFilter (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
visited Void all users who have visited the Paper doc.
shared Void All uses who are shared on the Paper doc. This includes all users who have visited the Paper doc as well as those who have not.
Returns
{
    "invitees": [
        {
            "invitee": {
                ".tag": "email",
                "email": "jessica@example.com"
            },
            "permission_level": {
                ".tag": "edit"
            }
        }
    ],
    "users": [
        {
            "user": {
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "same_team": true,
                "team_member_id": "dbmid:abcd1234"
            },
            "permission_level": {
                ".tag": "view_and_comment"
            }
        }
    ],
    "doc_owner": {
        "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
        "same_team": true,
        "team_member_id": "dbmid:abcd1234"
    },
    "cursor": {
        "value": "zHZvTPBnXilGgm1AmDgVyZ10zf7qb0qznd5sAVQbbIvoteSnWLjUdLU7aR25hb",
        "expiration": "2016-08-07T14:56:15Z"
    },
    "has_more": false
}
ListUsersOnPaperDocResponse
invitees List of (InviteeInfoWithPermissionLevel) List of email addresses with their respective permission levels that are invited on the Paper doc.
InviteeInfoWithPermissionLevel
invitee InviteeInfo Email invited to the Paper doc.
InviteeInfo (open union)
Information about the recipient of a shared content invitation. This datatype comes from an imported namespace originally defined in the sharing namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of invited user.
permission_level PaperDocPermissionLevel Permission level for the invitee.
PaperDocPermissionLevel (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit Void User will be granted edit permissions.
view_and_comment Void User will be granted view and comment permissions.
users List of (UserInfoWithPermissionLevel) List of users with their respective permission levels that are invited on the Paper folder.
UserInfoWithPermissionLevel
user UserInfo User shared on the Paper doc.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information. This datatype comes from an imported namespace originally defined in the sharing namespace.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
permission_level PaperDocPermissionLevel Permission level for the user.
PaperDocPermissionLevel (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit Void User will be granted edit permissions.
view_and_comment Void User will be granted view and comment permissions.
doc_owner UserInfo The Paper doc owner. This field is populated on every single response.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information. This datatype comes from an imported namespace originally defined in the sharing namespace.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
cursor Cursor Pass the cursor into docs/users/list/continue to paginate through all users. The cursor preserves all properties as specified in the original call to docs/users/list.
Cursor
value String The actual cursor value.
expiration Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Expiration time of value.
Some cursors might have expiration time assigned. This is a UTC value after which the cursor is no longer valid and the API starts returning an error. If cursor expires a new one needs to be obtained and pagination needs to be restarted. Some cursors might be short-lived some cursors might be long-lived.
This really depends on the sorting type and order, e.g.:
1. on one hand, listing docs created by the user, sorted by the created time ascending will have undefinite expiration because the results cannot change while the iteration is happening. This cursor would be suitable for long term polling.
2. on the other hand, listing docs sorted by the last modified time will have a very short expiration as docs do get modified very often and the modified time can be changed while the iteration is happening thus altering the results. This field is optional.
has_more Boolean Will be set to True if a subsequent call with the provided cursor to docs/users/list/continue returns immediately with some results. If set to False please allow some delay before making another call to docs/users/list/continue.
Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

/docs/users/list/continue

Description

Once a cursor has been retrieved from docs/users/list, use this to paginate through all users on the Paper doc.

URL Structure
https://api.dropboxapi.com/2/paper/docs/users/list/continue
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/users/list/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\",\"cursor\": \"U60b6BxT43ySd5sAVQbbIvoteSnWLjUdLU7aR25hbt3ySd5sAVQbbIvoteSnWLjUd\"}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q",
    "cursor": "U60b6BxT43ySd5sAVQbbIvoteSnWLjUdLU7aR25hbt3ySd5sAVQbbIvoteSnWLjUd"
}
ListUsersOnPaperDocContinueArgs
doc_id String
cursor String The cursor obtained from docs/users/list or docs/users/list/continue. Allows for pagination.
Returns
{
    "invitees": [
        {
            "invitee": {
                ".tag": "email",
                "email": "jessica@example.com"
            },
            "permission_level": {
                ".tag": "edit"
            }
        }
    ],
    "users": [
        {
            "user": {
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "same_team": true,
                "team_member_id": "dbmid:abcd1234"
            },
            "permission_level": {
                ".tag": "view_and_comment"
            }
        }
    ],
    "doc_owner": {
        "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
        "same_team": true,
        "team_member_id": "dbmid:abcd1234"
    },
    "cursor": {
        "value": "zHZvTPBnXilGgm1AmDgVyZ10zf7qb0qznd5sAVQbbIvoteSnWLjUdLU7aR25hb",
        "expiration": "2016-08-07T14:56:15Z"
    },
    "has_more": false
}
ListUsersOnPaperDocResponse
invitees List of (InviteeInfoWithPermissionLevel) List of email addresses with their respective permission levels that are invited on the Paper doc.
InviteeInfoWithPermissionLevel
invitee InviteeInfo Email invited to the Paper doc.
InviteeInfo (open union)
Information about the recipient of a shared content invitation. This datatype comes from an imported namespace originally defined in the sharing namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of invited user.
permission_level PaperDocPermissionLevel Permission level for the invitee.
PaperDocPermissionLevel (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit Void User will be granted edit permissions.
view_and_comment Void User will be granted view and comment permissions.
users List of (UserInfoWithPermissionLevel) List of users with their respective permission levels that are invited on the Paper folder.
UserInfoWithPermissionLevel
user UserInfo User shared on the Paper doc.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information. This datatype comes from an imported namespace originally defined in the sharing namespace.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
permission_level PaperDocPermissionLevel Permission level for the user.
PaperDocPermissionLevel (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit Void User will be granted edit permissions.
view_and_comment Void User will be granted view and comment permissions.
doc_owner UserInfo The Paper doc owner. This field is populated on every single response.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information. This datatype comes from an imported namespace originally defined in the sharing namespace.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
cursor Cursor Pass the cursor into docs/users/list/continue to paginate through all users. The cursor preserves all properties as specified in the original call to docs/users/list.
Cursor
value String The actual cursor value.
expiration Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Expiration time of value.
Some cursors might have expiration time assigned. This is a UTC value after which the cursor is no longer valid and the API starts returning an error. If cursor expires a new one needs to be obtained and pagination needs to be restarted. Some cursors might be short-lived some cursors might be long-lived.
This really depends on the sorting type and order, e.g.:
1. on one hand, listing docs created by the user, sorted by the created time ascending will have undefinite expiration because the results cannot change while the iteration is happening. This cursor would be suitable for long term polling.
2. on the other hand, listing docs sorted by the last modified time will have a very short expiration as docs do get modified very often and the modified time can be changed while the iteration is happening thus altering the results. This field is optional.
has_more Boolean Will be set to True if a subsequent call with the provided cursor to docs/users/list/continue returns immediately with some results. If set to False please allow some delay before making another call to docs/users/list/continue.
Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
ListUsersCursorError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.
cursor_error PaperApiCursorError
PaperApiCursorError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
expired_cursor Void The provided cursor is expired.
invalid_cursor Void The provided cursor is invalid.
wrong_user_in_cursor Void The provided cursor contains invalid user.
reset Void Indicates that the cursor has been invalidated. Call the corresponding non-continue endpoint to obtain a new cursor.

/docs/users/remove

Description

Allows an owner or editor to remove users from a Paper doc using their email or Dropbox account id.

Note: Doc owner cannot be removed.

URL Structure
https://api.dropboxapi.com/2/paper/docs/users/remove
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/paper/docs/users/remove \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"doc_id\": \"uaSvRuxvnkFa12PTkBv5q\",\"member\": {\".tag\": \"email\",\"email\": \"justin@example.com\"}}"
Parameters
{
    "doc_id": "uaSvRuxvnkFa12PTkBv5q",
    "member": {
        ".tag": "email",
        "email": "justin@example.com"
    }
}
RemovePaperDocUser
doc_id String
member MemberSelector User which should be removed from the Paper doc. Specify only email or Dropbox account id.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. This datatype comes from an imported namespace originally defined in the sharing namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
Returns

No return values.

Errors
Example: insufficient_permissions 
{
    "error_summary": "insufficient_permissions/...",
    "error": {
        ".tag": "insufficient_permissions"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: doc_not_found 
{
    "error_summary": "doc_not_found/...",
    "error": {
        ".tag": "doc_not_found"
    }
}
DocLookupError (union)
The value will be one of the following datatypes:
insufficient_permissions Void Your account does not have permissions to perform this action.
doc_not_found Void The required doc was not found.

sharing

This namespace contains endpoints and data types for creating and managing shared links and shared folders.

/add_file_member

Description

Adds specified members to a file.

URL Structure
https://api.dropboxapi.com/2/sharing/add_file_member
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/add_file_member \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"file\": \"id:3kmLmQFnf1AAAAAAAAAAAw\",\"members\": [{\".tag\": \"email\",\"email\": \"justin@example.com\"}],\"custom_message\": \"This is a custom message about ACME.doc\",\"quiet\": false,\"access_level\": \"viewer\",\"add_message_as_comment\": false}"
Parameters
{
    "file": "id:3kmLmQFnf1AAAAAAAAAAAw",
    "members": [
        {
            ".tag": "email",
            "email": "justin@example.com"
        }
    ],
    "custom_message": "This is a custom message about ACME.doc",
    "quiet": false,
    "access_level": "viewer",
    "add_message_as_comment": false
}
AddFileMemberArgs
Arguments for add_file_member.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") File to which to add members.
members List of (MemberSelector) Members to add. Note that even an email address is given, this may result in a user being directy added to the membership if that email is the user's main account email.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
custom_message String? Message to send to added members in their invitation. This field is optional.
quiet Boolean Whether added members should be notified via device notifications of their invitation. The default for this field is False.
access_level AccessLevel AccessLevel union object, describing what access level we want to give new members. The default for this union is viewer.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
add_message_as_comment Boolean If the custom message should be added as a comment on the file. The default for this field is False.
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
FileMemberActionResult
Per-member result for add_file_member or change_file_member_access.
member MemberSelector One of specified input members.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
result FileMemberActionIndividualResult The outcome of the action on this member.
FileMemberActionIndividualResult (union)
The value will be one of the following datatypes:
success AccessLevel? Member was successfully removed from this file. If AccessLevel is given, the member still has access via a parent shared folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
member_error FileMemberActionError User was not able to perform this action.
FileMemberActionError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_member Void Specified member was not found.
no_permission Void User does not have permission to perform this action on this member.
access_error SharingFileAccessError Specified file was invalid or user does not have access.
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
no_explicit_access MemberAccessLevelResult The action cannot be completed because the target member does not have explicit access to the file. The return value is the access that the member has to the file from a parent folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
Example: rate_limit 
{
    "error_summary": "rate_limit/...",
    "error": {
        ".tag": "rate_limit"
    }
}
Example: invalid_comment 
{
    "error_summary": "invalid_comment/...",
    "error": {
        ".tag": "invalid_comment"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
AddFileMemberError (open union)
Errors for add_file_member. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_error SharingUserError
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.
access_error SharingFileAccessError
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
rate_limit Void The user has reached the rate limit for invitations.
invalid_comment Void The custom message did not pass comment permissions checks.

/add_folder_member

Description

Allows an owner or editor (if the ACL update policy allows) of a shared folder to add another member.
For the new member to get access to all the functionality for this folder, you will need to call mount_folder on their behalf.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/add_folder_member
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/add_folder_member \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\",\"members\": [{\"member\": {\".tag\": \"email\",\"email\": \"justin@example.com\"},\"access_level\": {\".tag\": \"editor\"}},{\"member\": {\".tag\": \"dropbox_id\",\"dropbox_id\": \"dbid:AAEufNrMPSPe0dMQijRP0N_aZtBJRm26W4Q\"},\"access_level\": {\".tag\": \"viewer\"}}],\"quiet\": false,\"custom_message\": \"Documentation for launch day\"}"
Parameters
{
    "shared_folder_id": "84528192421",
    "members": [
        {
            "member": {
                ".tag": "email",
                "email": "justin@example.com"
            },
            "access_level": {
                ".tag": "editor"
            }
        },
        {
            "member": {
                ".tag": "dropbox_id",
                "dropbox_id": "dbid:AAEufNrMPSPe0dMQijRP0N_aZtBJRm26W4Q"
            },
            "access_level": {
                ".tag": "viewer"
            }
        }
    ],
    "quiet": false,
    "custom_message": "Documentation for launch day"
}
AddFolderMemberArg
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
members List of (AddMember) The intended list of members to add. Added members will receive invites to join the shared folder.
AddMember
The member and type of access the member should have when added to a shared folder.
member MemberSelector The member to add to the shared folder.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
access_level AccessLevel The access level to grant member to the shared folder. AccessLevel.owner is disallowed. The default for this union is viewer.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
quiet Boolean Whether added members should be notified via email and device notifications of their invite. The default for this field is False.
custom_message String(min_length=1)? Optional message to display to added members in their invitation. This field is optional.
Returns

No return values.

Errors
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: member 
{
    "error_summary": "bad_member/invalid_dropbox_id/...",
    "error": {
        ".tag": "bad_member",
        "bad_member": {
            ".tag": "invalid_dropbox_id",
            "invalid_dropbox_id": "dbid:AAEufNrMPSPe0dMQijRP0N_aZtBJRm26W4Q"
        }
    }
}
Example: email_unverified 
{
    "error_summary": "email_unverified/...",
    "error": {
        ".tag": "email_unverified"
    }
}
Example: cant_share_outside_team 
{
    "error_summary": "cant_share_outside_team/...",
    "error": {
        ".tag": "cant_share_outside_team"
    }
}
Example: rate_limit 
{
    "error_summary": "rate_limit/...",
    "error": {
        ".tag": "rate_limit"
    }
}
Example: too_many_invitees 
{
    "error_summary": "too_many_invitees/...",
    "error": {
        ".tag": "too_many_invitees"
    }
}
Example: insufficient_plan 
{
    "error_summary": "insufficient_plan/...",
    "error": {
        ".tag": "insufficient_plan"
    }
}
Example: team_folder 
{
    "error_summary": "team_folder/...",
    "error": {
        ".tag": "team_folder"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
AddFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError Unable to access shared folder.
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
email_unverified Void The current user's e-mail address is unverified.
bad_member AddMemberSelectorError AddFolderMemberArg.members contains a bad invitation recipient.
AddMemberSelectorError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
automatic_group Void Automatically created groups can only be added to team folders.
invalid_dropbox_id String(min_length=1) The value is the ID that could not be identified.
invalid_email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") The value is the e-email address that is malformed.
unverified_dropbox_id String(min_length=1) The value is the ID of the Dropbox user with an unverified e-mail address. Invite unverified users by e-mail address instead of by their Dropbox ID.
group_deleted Void At least one of the specified groups in AddFolderMemberArg.members is deleted.
group_not_on_team Void Sharing to a group that is not on the current user's team.
cant_share_outside_team Void Your team policy does not allow sharing outside of the team.
too_many_members UInt64 The value is the member limit that was reached.
too_many_pending_invites UInt64 The value is the pending invite limit that was reached.
rate_limit Void The current user has hit the limit of invites they can send per day. Try again in 24 hours.
too_many_invitees Void The current user is trying to share with too many people at once.
insufficient_plan Void The current user's account doesn't support this action. An example of this is when adding a read-only member. This action can only be performed by users that have upgraded to a Pro or Business plan.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.

/change_file_member_access

DEPRECATED BY /update_file_member
Description

Identical to update_file_member but with less information returned.

URL Structure
https://api.dropboxapi.com/2/sharing/change_file_member_access
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/change_file_member_access \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"file\": \"id:3kmLmQFnf1AAAAAAAAAAAw\",\"member\": {\".tag\": \"email\",\"email\": \"justin@example.com\"},\"access_level\": \"viewer\"}"
Parameters
{
    "file": "id:3kmLmQFnf1AAAAAAAAAAAw",
    "member": {
        ".tag": "email",
        "email": "justin@example.com"
    },
    "access_level": "viewer"
}
ChangeFileMemberAccessArgs
Arguments for change_file_member_access.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") File for which we are changing a member's access.
member MemberSelector The member whose access we are changing.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
access_level AccessLevel The new access level for the member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
Returns
FileMemberActionResult
Per-member result for add_file_member or change_file_member_access.
member MemberSelector One of specified input members.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
result FileMemberActionIndividualResult The outcome of the action on this member.
FileMemberActionIndividualResult (union)
The value will be one of the following datatypes:
success AccessLevel? Member was successfully removed from this file. If AccessLevel is given, the member still has access via a parent shared folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
member_error FileMemberActionError User was not able to perform this action.
FileMemberActionError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_member Void Specified member was not found.
no_permission Void User does not have permission to perform this action on this member.
access_error SharingFileAccessError Specified file was invalid or user does not have access.
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
no_explicit_access MemberAccessLevelResult The action cannot be completed because the target member does not have explicit access to the file. The return value is the access that the member has to the file from a parent folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
Example: invalid_member 
{
    "error_summary": "invalid_member/...",
    "error": {
        ".tag": "invalid_member"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
FileMemberActionError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_member Void Specified member was not found.
no_permission Void User does not have permission to perform this action on this member.
access_error SharingFileAccessError Specified file was invalid or user does not have access.
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
no_explicit_access MemberAccessLevelResult The action cannot be completed because the target member does not have explicit access to the file. The return value is the access that the member has to the file from a parent folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.

/check_job_status

Description

Returns the status of an asynchronous job.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/check_job_status
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/check_job_status \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"async_job_id\": \"34g93hh34h04y384084\"}"
Parameters
{
    "async_job_id": "34g93hh34h04y384084"
}
PollArg
Arguments for methods that poll the status of an asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace.
async_job_id String(min_length=1) Id of the asynchronous job. This is the value of a response returned from the method that launched the job.
Returns
Example: in_progress 
{
    ".tag": "in_progress"
}
Example: complete 
{
    ".tag": "complete"
}
JobStatus (union)
The value will be one of the following datatypes:
in_progress Void The asynchronous job is still in progress.
complete Void The asynchronous job has finished.
failed JobError The asynchronous job returned an error.
JobError (open union)
Error occurred while performing an asynchronous job from unshare_folder or remove_folder_member. The value will be one of the following datatypes. New values may be introduced as our API evolves.
unshare_folder_error UnshareFolderError Error occurred while performing unshare_folder action.
UnshareFolderError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.
too_many_files Void This shared folder has too many files to be unshared.
remove_folder_member_error RemoveFolderMemberError Error occurred while performing remove_folder_member action.
RemoveFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
member_error SharedFolderMemberError
SharedFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_dropbox_id Void The target dropbox_id is invalid.
not_a_member Void The target dropbox_id is not a member of the shared folder.
no_explicit_access MemberAccessLevelResult The target member only has inherited access to the shared folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
folder_owner Void The target user is the owner of the shared folder. You can't remove this user until ownership has been transferred to another member.
group_access Void The target user has access to the shared folder via a group.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.
relinquish_folder_membership_error RelinquishFolderMembershipError Error occurred while performing relinquish_folder_membership action.
RelinquishFolderMembershipError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
folder_owner Void The current user is the owner of the shared folder. Owners cannot relinquish membership to their own folders. Try unsharing or transferring ownership first.
mounted Void The shared folder is currently mounted. Unmount the shared folder before relinquishing membership.
group_access Void The current user has access to the shared folder via a group. You can't relinquish membership to folders shared via groups.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.
no_explicit_access Void The current user only has inherited access to the shared folder. You can't relinquish inherited membership to folders.
Errors
Example: invalid_async_job_id 
{
    "error_summary": "invalid_async_job_id/...",
    "error": {
        ".tag": "invalid_async_job_id"
    }
}
Example: internal_error 
{
    "error_summary": "internal_error/...",
    "error": {
        ".tag": "internal_error"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
PollError (open union)
Error returned by methods for polling the status of asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_async_job_id Void The job ID is invalid.
internal_error Void Something went wrong with the job on Dropbox's end. You'll need to verify that the action you were taking succeeded, and if not, try again. This should happen very rarely.

/check_remove_member_job_status

Description

Returns the status of an asynchronous job for sharing a folder.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/check_remove_member_job_status
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/check_remove_member_job_status \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"async_job_id\": \"34g93hh34h04y384084\"}"
Parameters
{
    "async_job_id": "34g93hh34h04y384084"
}
PollArg
Arguments for methods that poll the status of an asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace.
async_job_id String(min_length=1) Id of the asynchronous job. This is the value of a response returned from the method that launched the job.
Returns
{
    ".tag": "complete"
}
Example: in_progress 
{
    ".tag": "in_progress"
}
RemoveMemberJobStatus (union)
The value will be one of the following datatypes:
in_progress Void The asynchronous job is still in progress.
complete MemberAccessLevelResult Removing the folder member has finished. The value is information about whether the member has another form of access.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
failed RemoveFolderMemberError
RemoveFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
member_error SharedFolderMemberError
SharedFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_dropbox_id Void The target dropbox_id is invalid.
not_a_member Void The target dropbox_id is not a member of the shared folder.
no_explicit_access MemberAccessLevelResult The target member only has inherited access to the shared folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
folder_owner Void The target user is the owner of the shared folder. You can't remove this user until ownership has been transferred to another member.
group_access Void The target user has access to the shared folder via a group.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.
Errors
Example: invalid_async_job_id 
{
    "error_summary": "invalid_async_job_id/...",
    "error": {
        ".tag": "invalid_async_job_id"
    }
}
Example: internal_error 
{
    "error_summary": "internal_error/...",
    "error": {
        ".tag": "internal_error"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
PollError (open union)
Error returned by methods for polling the status of asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_async_job_id Void The job ID is invalid.
internal_error Void Something went wrong with the job on Dropbox's end. You'll need to verify that the action you were taking succeeded, and if not, try again. This should happen very rarely.

/check_share_job_status

Description

Returns the status of an asynchronous job for sharing a folder.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/check_share_job_status
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/check_share_job_status \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"async_job_id\": \"34g93hh34h04y384084\"}"
Parameters
{
    "async_job_id": "34g93hh34h04y384084"
}
PollArg
Arguments for methods that poll the status of an asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace.
async_job_id String(min_length=1) Id of the asynchronous job. This is the value of a response returned from the method that launched the job.
Returns
{
    ".tag": "complete",
    "access_type": {
        ".tag": "owner"
    },
    "is_team_folder": false,
    "policy": {
        "acl_update_policy": {
            ".tag": "owner"
        },
        "shared_link_policy": {
            ".tag": "anyone"
        },
        "member_policy": {
            ".tag": "anyone"
        },
        "resolved_member_policy": {
            ".tag": "team"
        }
    },
    "name": "dir",
    "shared_folder_id": "84528192421",
    "time_invited": "2016-01-20T00:00:00Z",
    "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
    "path_lower": "/dir",
    "permissions": []
}
Example: in_progress 
{
    ".tag": "in_progress"
}
ShareFolderJobStatus (union)
The value will be one of the following datatypes:
in_progress Void The asynchronous job is still in progress.
complete SharedFolderMetadata The share job has finished. The value is the metadata for the folder.
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
failed ShareFolderError
ShareFolderError (union)
The value will be one of the following datatypes:
email_unverified Void The current user's e-mail address is unverified.
bad_path SharePathError ShareFolderArg.path is invalid.
SharePathError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
is_file Void A file is at the specified path.
inside_shared_folder Void We do not support sharing a folder inside a shared folder.
contains_shared_folder Void We do not support shared folders that contain shared folders.
contains_app_folder Void We do not support shared folders that contain app folders.
contains_team_folder Void We do not support shared folders that contain team folders.
is_app_folder Void We do not support sharing an app folder.
inside_app_folder Void We do not support sharing a folder inside an app folder.
is_public_folder Void A public folder can't be shared this way. Use a public link instead.
inside_public_folder Void A folder inside a public folder can't be shared this way. Use a public link instead.
already_shared SharedFolderMetadata Folder is already shared. Contains metadata about the existing shared folder.
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
invalid_path Void Path is not valid.
is_osx_package Void We do not support sharing a Mac OS X package.
inside_osx_package Void We do not support sharing a folder inside a Mac OS X package.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
This datatype comes from an imported namespace originally defined in the files namespace.
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
team_policy_disallows_member_policy Void Team policy is more restrictive than ShareFolderArg.member_policy.
disallowed_shared_link_policy Void The current user's account is not allowed to select the specified ShareFolderArg.shared_link_policy.
no_permission Void The current user does not have permission to perform this action.
Errors
Example: invalid_async_job_id 
{
    "error_summary": "invalid_async_job_id/...",
    "error": {
        ".tag": "invalid_async_job_id"
    }
}
Example: internal_error 
{
    "error_summary": "internal_error/...",
    "error": {
        ".tag": "internal_error"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
PollError (open union)
Error returned by methods for polling the status of asynchronous job. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_async_job_id Void The job ID is invalid.
internal_error Void Something went wrong with the job on Dropbox's end. You'll need to verify that the action you were taking succeeded, and if not, try again. This should happen very rarely.

/get_file_metadata

Description

Returns shared file metadata.

URL Structure
https://api.dropboxapi.com/2/sharing/get_file_metadata
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/get_file_metadata \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"file\": \"id:3kmLmQFnf1AAAAAAAAAAAw\",\"actions\": []}"
Parameters
{
    "file": "id:3kmLmQFnf1AAAAAAAAAAAw",
    "actions": []
}
GetFileMetadataArg
Arguments of get_file_metadata.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") The file to query.
actions List of (FileAction)? File actions to query. This field is optional.
FileAction (open union)
Sharing actions that may be taken on files. The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit_contents Void Change or edit contents of the file.
invite_viewer Void Add a member with view permissions.
invite_viewer_no_comment Void Add a member with view permissions but no comment permissions.
unshare Void Stop sharing this file.
relinquish_membership Void Relinquish one's own membership to the file.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link to the file.
Returns
{
    "policy": {
        "acl_update_policy": {
            ".tag": "owner"
        },
        "shared_link_policy": {
            ".tag": "anyone"
        },
        "member_policy": {
            ".tag": "anyone"
        },
        "resolved_member_policy": {
            ".tag": "team"
        }
    },
    "preview_url": "https://www.dropbox.com/scl/fi/fir9vjelf",
    "name": "file.txt",
    "id": "id:3kmLmQFnf1AAAAAAAAAAAw",
    "permissions": [],
    "owner_team": {
        "id": "dbtid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I",
        "name": "Acme, Inc."
    },
    "path_lower": "/dir/file.txt",
    "path_display": "/dir/file.txt",
    "time_invited": "2016-01-20T00:00:00Z"
}
SharedFileMetadata
Properties of the shared file.
policy FolderPolicy Policies governing this shared file.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
preview_url String URL for displaying a web preview of the shared file.
name String The name of this file.
id String(min_length=1, pattern="id:.*") The ID of the file.
permissions List of (FilePermission)? The sharing permissions that requesting user has on this file. This corresponds to the entries given in GetFileMetadataBatchArg.actions or GetFileMetadataArg.actions. This field is optional.
FilePermission
Whether the user is allowed to take the sharing action on the file.
action FileAction The action that the user may wish to take on the file.
FileAction (open union)
Sharing actions that may be taken on files. The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit_contents Void Change or edit contents of the file.
invite_viewer Void Add a member with view permissions.
invite_viewer_no_comment Void Add a member with view permissions but no comment permissions.
unshare Void Stop sharing this file.
relinquish_membership Void Relinquish one's own membership to the file.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link to the file.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
owner_team Team? The team that owns the file. This field is not present if the file is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the file is contained within a shared folder. This field is optional.
path_lower String? The lower-case full path of this file. Absent for unmounted files. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1. Absent for unmounted files. This field is optional.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Timestamp indicating when the current user was invited to this shared file. If the user was not invited to the shared file, the timestamp will indicate when the user was invited to the parent shared folder. This value may be absent. This field is optional.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GetFileMetadataError (open union)
Error result for get_file_metadata. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_error SharingUserError
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.
access_error SharingFileAccessError
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.

/get_file_metadata/batch

Description

Returns shared file metadata.

URL Structure
https://api.dropboxapi.com/2/sharing/get_file_metadata/batch
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/get_file_metadata/batch \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"files\": [\"id:3kmLmQFnf1AAAAAAAAAAAw\",\"id:VvTaJu2VZzAAAAAAAAAADQ\"],\"actions\": []}"
Parameters
{
    "files": [
        "id:3kmLmQFnf1AAAAAAAAAAAw",
        "id:VvTaJu2VZzAAAAAAAAAADQ"
    ],
    "actions": []
}
GetFileMetadataBatchArg
Arguments of get_file_metadata/batch.
files List of (String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?"), max_items=100) The files to query.
actions List of (FileAction)? File actions to query. This field is optional.
FileAction (open union)
Sharing actions that may be taken on files. The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit_contents Void Change or edit contents of the file.
invite_viewer Void Add a member with view permissions.
invite_viewer_no_comment Void Add a member with view permissions but no comment permissions.
unshare Void Stop sharing this file.
relinquish_membership Void Relinquish one's own membership to the file.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link to the file.
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
GetFileMetadataBatchResult
Per file results of get_file_metadata/batch.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") This is the input file identifier corresponding to one of GetFileMetadataBatchArg.files.
result GetFileMetadataIndividualResult The result for this particular file.
GetFileMetadataIndividualResult (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
metadata SharedFileMetadata The result for this file if it was successful.
SharedFileMetadata
Properties of the shared file.
policy FolderPolicy Policies governing this shared file.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
preview_url String URL for displaying a web preview of the shared file.
name String The name of this file.
id String(min_length=1, pattern="id:.*") The ID of the file.
permissions List of (FilePermission)? The sharing permissions that requesting user has on this file. This corresponds to the entries given in GetFileMetadataBatchArg.actions or GetFileMetadataArg.actions. This field is optional.
FilePermission
Whether the user is allowed to take the sharing action on the file.
action FileAction The action that the user may wish to take on the file.
FileAction (open union)
Sharing actions that may be taken on files. The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit_contents Void Change or edit contents of the file.
invite_viewer Void Add a member with view permissions.
invite_viewer_no_comment Void Add a member with view permissions but no comment permissions.
unshare Void Stop sharing this file.
relinquish_membership Void Relinquish one's own membership to the file.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link to the file.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
owner_team Team? The team that owns the file. This field is not present if the file is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the file is contained within a shared folder. This field is optional.
path_lower String? The lower-case full path of this file. Absent for unmounted files. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1. Absent for unmounted files. This field is optional.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Timestamp indicating when the current user was invited to this shared file. If the user was not invited to the shared file, the timestamp will indicate when the user was invited to the parent shared folder. This value may be absent. This field is optional.
access_error SharingFileAccessError The result for this file if it was an error.
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
Errors
Example: email_unverified 
{
    "error_summary": "email_unverified/...",
    "error": {
        ".tag": "email_unverified"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.

/get_folder_metadata

Description

Returns shared folder metadata by its folder ID.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/get_folder_metadata
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/get_folder_metadata \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\",\"actions\": []}"
Parameters
{
    "shared_folder_id": "84528192421",
    "actions": []
}
GetMetadataArgs
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
actions List of (FolderAction)? This is a list indicating whether the returned folder data will include a boolean value FolderPermission.allow that describes whether the current user can perform the FolderAction on the folder. This field is optional.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
Returns
{
    "access_type": {
        ".tag": "owner"
    },
    "is_team_folder": false,
    "policy": {
        "acl_update_policy": {
            ".tag": "owner"
        },
        "shared_link_policy": {
            ".tag": "anyone"
        },
        "member_policy": {
            ".tag": "anyone"
        },
        "resolved_member_policy": {
            ".tag": "team"
        }
    },
    "name": "dir",
    "shared_folder_id": "84528192421",
    "time_invited": "2016-01-20T00:00:00Z",
    "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
    "path_lower": "/dir",
    "permissions": []
}
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
Example: invalid_id 
{
    "error_summary": "invalid_id/...",
    "error": {
        ".tag": "invalid_id"
    }
}
Example: not_a_member 
{
    "error_summary": "not_a_member/...",
    "error": {
        ".tag": "not_a_member"
    }
}
Example: email_unverified 
{
    "error_summary": "email_unverified/...",
    "error": {
        ".tag": "email_unverified"
    }
}
Example: unmounted 
{
    "error_summary": "unmounted/...",
    "error": {
        ".tag": "unmounted"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.

/list_file_members

Description

Use to obtain the members who have been invited to a file, both inherited and uninherited members.

URL Structure
https://api.dropboxapi.com/2/sharing/list_file_members
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_file_members \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"file\": \"id:3kmLmQFnf1AAAAAAAAAAAw\",\"include_inherited\": true,\"limit\": 100}"
Parameters
{
    "file": "id:3kmLmQFnf1AAAAAAAAAAAw",
    "include_inherited": true,
    "limit": 100
}
ListFileMembersArg
Arguments for list_file_members.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") The file for which you want to see members.
actions List of (MemberAction)? The actions for which to return permissions on a member. This field is optional.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
include_inherited Boolean Whether to include members who only have access from a parent shared folder. The default for this field is True.
limit UInt32 Number of members to return max per query. Defaults to 100 if no limit is specified. The default for this field is 100.
Returns
{
    "users": [
        {
            "access_type": {
                ".tag": "owner"
            },
            "user": {
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "same_team": true,
                "team_member_id": "dbmid:abcd1234"
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "groups": [
        {
            "access_type": {
                ".tag": "editor"
            },
            "group": {
                "group_name": "Test group",
                "group_id": "g:e2db7665347abcd600000000001a2b3c",
                "group_management_type": {
                    ".tag": "user_managed"
                },
                "group_type": {
                    ".tag": "user_managed"
                },
                "is_member": false,
                "is_owner": false,
                "same_team": true,
                "member_count": 10
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "invitees": [
        {
            "access_type": {
                ".tag": "viewer"
            },
            "invitee": {
                ".tag": "email",
                "email": "jessica@example.com"
            },
            "permissions": [],
            "is_inherited": false
        }
    ]
}
SharedFileMembers
Shared file user, group, and invitee membership.
Used for the results of list_file_members and list_file_members/continue, and used as part of the results for list_file_members/batch.
users List of (UserMembershipInfo) The list of user members of the shared file.
UserMembershipInfo
The information about a user member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
user UserInfo The account information for the membership user.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
groups List of (GroupMembershipInfo) The list of group members of the shared file.
GroupMembershipInfo
The information about a group member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
group GroupInfo The information about the membership group.
GroupInfo
The information about a group. Groups is a way to manage a list of users who need same access permission to the shared folder.
group_name String
group_id String
group_management_type GroupManagementType Who is allowed to manage the group.
GroupManagementType (open union)
The group type determines how a group is managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
company_managed Void A group which is managed by team admins only.
user_managed Void A group which is managed by selected users.
group_type GroupType The type of group.
GroupType (open union)
The group type determines how a group is created and managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void A group to which team members are automatically added. Applicable to team folders only.
user_managed Void A group is created and managed by a user.
is_member Boolean If the current user is a member of the group.
is_owner Boolean If the current user is an owner of the group.
same_team Boolean If the group is owned by the current user's team.
group_external_id String? External ID of group. This is an arbitrary ID that an admin can attach to a group. This field is optional.
member_count UInt32? The number of members in the group. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
invitees List of (InviteeMembershipInfo) The list of invited members of a file, but have not logged in and claimed this.
InviteeMembershipInfo
Information about an invited member of a shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
invitee InviteeInfo Recipient of the invitation.
InviteeInfo (open union)
Information about the recipient of a shared content invitation. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of invited user.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
user UserInfo? The user this invitation is tied to, if available. This field is optional.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
cursor String? Present if there are additional shared file members that have not been returned yet. Pass the cursor into list_file_members/continue to list additional members. This field is optional.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFileMembersError (open union)
Error for list_file_members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_error SharingUserError
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.
access_error SharingFileAccessError
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.

/list_file_members/batch

Description

Get members of multiple files at once. The arguments to this route are more limited, and the limit on query result size per file is more strict. To customize the results more, use the individual file endpoint.
Inherited users and groups are not included in the result, and permissions are not returned for this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/list_file_members/batch
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_file_members/batch \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"files\": [\"id:3kmLmQFnf1AAAAAAAAAAAw\",\"id:VvTaJu2VZzAAAAAAAAAADQ\"],\"limit\": 10}"
Parameters
{
    "files": [
        "id:3kmLmQFnf1AAAAAAAAAAAw",
        "id:VvTaJu2VZzAAAAAAAAAADQ"
    ],
    "limit": 10
}
ListFileMembersBatchArg
Arguments for list_file_members/batch.
files List of (String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?"), max_items=100) Files for which to return members.
limit UInt32 Number of members to return max per query. Defaults to 10 if no limit is specified. The default for this field is 10.
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
ListFileMembersBatchResult
Per-file result for list_file_members/batch.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") This is the input file identifier, whether an ID or a path.
result ListFileMembersIndividualResult The result for this particular file.
ListFileMembersIndividualResult (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
result ListFileMembersCountResult The results of the query for this file if it was successful.
ListFileMembersCountResult
members SharedFileMembers A list of members on this file.
SharedFileMembers
Shared file user, group, and invitee membership.
Used for the results of list_file_members and list_file_members/continue, and used as part of the results for list_file_members/batch.
users List of (UserMembershipInfo) The list of user members of the shared file.
UserMembershipInfo
The information about a user member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
user UserInfo The account information for the membership user.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
groups List of (GroupMembershipInfo) The list of group members of the shared file.
GroupMembershipInfo
The information about a group member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
group GroupInfo The information about the membership group.
GroupInfo
The information about a group. Groups is a way to manage a list of users who need same access permission to the shared folder.
group_name String
group_id String
group_management_type GroupManagementType Who is allowed to manage the group.
GroupManagementType (open union)
The group type determines how a group is managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
company_managed Void A group which is managed by team admins only.
user_managed Void A group which is managed by selected users.
group_type GroupType The type of group.
GroupType (open union)
The group type determines how a group is created and managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void A group to which team members are automatically added. Applicable to team folders only.
user_managed Void A group is created and managed by a user.
is_member Boolean If the current user is a member of the group.
is_owner Boolean If the current user is an owner of the group.
same_team Boolean If the group is owned by the current user's team.
group_external_id String? External ID of group. This is an arbitrary ID that an admin can attach to a group. This field is optional.
member_count UInt32? The number of members in the group. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
invitees List of (InviteeMembershipInfo) The list of invited members of a file, but have not logged in and claimed this.
InviteeMembershipInfo
Information about an invited member of a shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
invitee InviteeInfo Recipient of the invitation.
InviteeInfo (open union)
Information about the recipient of a shared content invitation. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of invited user.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
user UserInfo? The user this invitation is tied to, if available. This field is optional.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
cursor String? Present if there are additional shared file members that have not been returned yet. Pass the cursor into list_file_members/continue to list additional members. This field is optional.
member_count UInt32 The number of members on this file. This does not include inherited members.
access_error SharingFileAccessError The result of the query for this file if it was an error.
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
Errors
Example: email_unverified 
{
    "error_summary": "email_unverified/...",
    "error": {
        ".tag": "email_unverified"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.

/list_file_members/continue

Description

Once a cursor has been retrieved from list_file_members or list_file_members/batch, use this to paginate through all shared file members.

URL Structure
https://api.dropboxapi.com/2/sharing/list_file_members/continue
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_file_members/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFileMembersContinueArg
Arguments for list_file_members/continue.
cursor String The cursor returned by your last call to list_file_members, list_file_members/continue, or list_file_members/batch.
Returns
{
    "users": [
        {
            "access_type": {
                ".tag": "owner"
            },
            "user": {
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "same_team": true,
                "team_member_id": "dbmid:abcd1234"
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "groups": [
        {
            "access_type": {
                ".tag": "editor"
            },
            "group": {
                "group_name": "Test group",
                "group_id": "g:e2db7665347abcd600000000001a2b3c",
                "group_management_type": {
                    ".tag": "user_managed"
                },
                "group_type": {
                    ".tag": "user_managed"
                },
                "is_member": false,
                "is_owner": false,
                "same_team": true,
                "member_count": 10
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "invitees": [
        {
            "access_type": {
                ".tag": "viewer"
            },
            "invitee": {
                ".tag": "email",
                "email": "jessica@example.com"
            },
            "permissions": [],
            "is_inherited": false
        }
    ]
}
SharedFileMembers
Shared file user, group, and invitee membership.
Used for the results of list_file_members and list_file_members/continue, and used as part of the results for list_file_members/batch.
users List of (UserMembershipInfo) The list of user members of the shared file.
UserMembershipInfo
The information about a user member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
user UserInfo The account information for the membership user.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
groups List of (GroupMembershipInfo) The list of group members of the shared file.
GroupMembershipInfo
The information about a group member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
group GroupInfo The information about the membership group.
GroupInfo
The information about a group. Groups is a way to manage a list of users who need same access permission to the shared folder.
group_name String
group_id String
group_management_type GroupManagementType Who is allowed to manage the group.
GroupManagementType (open union)
The group type determines how a group is managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
company_managed Void A group which is managed by team admins only.
user_managed Void A group which is managed by selected users.
group_type GroupType The type of group.
GroupType (open union)
The group type determines how a group is created and managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void A group to which team members are automatically added. Applicable to team folders only.
user_managed Void A group is created and managed by a user.
is_member Boolean If the current user is a member of the group.
is_owner Boolean If the current user is an owner of the group.
same_team Boolean If the group is owned by the current user's team.
group_external_id String? External ID of group. This is an arbitrary ID that an admin can attach to a group. This field is optional.
member_count UInt32? The number of members in the group. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
invitees List of (InviteeMembershipInfo) The list of invited members of a file, but have not logged in and claimed this.
InviteeMembershipInfo
Information about an invited member of a shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
invitee InviteeInfo Recipient of the invitation.
InviteeInfo (open union)
Information about the recipient of a shared content invitation. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of invited user.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
user UserInfo? The user this invitation is tied to, if available. This field is optional.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
cursor String? Present if there are additional shared file members that have not been returned yet. Pass the cursor into list_file_members/continue to list additional members. This field is optional.
Errors
Example: invalid_cursor 
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFileMembersContinueError (open union)
Error for list_file_members/continue. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_error SharingUserError
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.
access_error SharingFileAccessError
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
invalid_cursor Void ListFileMembersContinueArg.cursor is invalid.

/list_folder_members

Description

Returns shared folder membership by its folder ID.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/list_folder_members
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_folder_members \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\",\"actions\": [],\"limit\": 10}"
Parameters
{
    "shared_folder_id": "84528192421",
    "actions": [],
    "limit": 10
}
ListFolderMembersArgs
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
actions List of (MemberAction)? This is a list indicating whether each returned member will include a boolean value MemberPermission.allow that describes whether the current user can perform the MemberAction on the member. This field is optional.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
limit UInt32 The maximum number of results that include members, groups and invitees to return per request. The default for this field is 1000.
Returns
{
    "users": [
        {
            "access_type": {
                ".tag": "owner"
            },
            "user": {
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "same_team": true,
                "team_member_id": "dbmid:abcd1234"
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "groups": [
        {
            "access_type": {
                ".tag": "editor"
            },
            "group": {
                "group_name": "Test group",
                "group_id": "g:e2db7665347abcd600000000001a2b3c",
                "group_management_type": {
                    ".tag": "user_managed"
                },
                "group_type": {
                    ".tag": "user_managed"
                },
                "is_member": false,
                "is_owner": false,
                "same_team": true,
                "member_count": 10
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "invitees": [
        {
            "access_type": {
                ".tag": "viewer"
            },
            "invitee": {
                ".tag": "email",
                "email": "jessica@example.com"
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
SharedFolderMembers
Shared folder user and group membership.
users List of (UserMembershipInfo) The list of user members of the shared folder.
UserMembershipInfo
The information about a user member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
user UserInfo The account information for the membership user.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
groups List of (GroupMembershipInfo) The list of group members of the shared folder.
GroupMembershipInfo
The information about a group member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
group GroupInfo The information about the membership group.
GroupInfo
The information about a group. Groups is a way to manage a list of users who need same access permission to the shared folder.
group_name String
group_id String
group_management_type GroupManagementType Who is allowed to manage the group.
GroupManagementType (open union)
The group type determines how a group is managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
company_managed Void A group which is managed by team admins only.
user_managed Void A group which is managed by selected users.
group_type GroupType The type of group.
GroupType (open union)
The group type determines how a group is created and managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void A group to which team members are automatically added. Applicable to team folders only.
user_managed Void A group is created and managed by a user.
is_member Boolean If the current user is a member of the group.
is_owner Boolean If the current user is an owner of the group.
same_team Boolean If the group is owned by the current user's team.
group_external_id String? External ID of group. This is an arbitrary ID that an admin can attach to a group. This field is optional.
member_count UInt32? The number of members in the group. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
invitees List of (InviteeMembershipInfo) The list of invitees to the shared folder.
InviteeMembershipInfo
Information about an invited member of a shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
invitee InviteeInfo Recipient of the invitation.
InviteeInfo (open union)
Information about the recipient of a shared content invitation. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of invited user.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
user UserInfo? The user this invitation is tied to, if available. This field is optional.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
cursor String? Present if there are additional shared folder members that have not been returned yet. Pass the cursor into list_folder_members/continue to list additional members. This field is optional.
Errors
Example: invalid_id 
{
    "error_summary": "invalid_id/...",
    "error": {
        ".tag": "invalid_id"
    }
}
Example: not_a_member 
{
    "error_summary": "not_a_member/...",
    "error": {
        ".tag": "not_a_member"
    }
}
Example: email_unverified 
{
    "error_summary": "email_unverified/...",
    "error": {
        ".tag": "email_unverified"
    }
}
Example: unmounted 
{
    "error_summary": "unmounted/...",
    "error": {
        ".tag": "unmounted"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.

/list_folder_members/continue

Description

Once a cursor has been retrieved from list_folder_members, use this to paginate through all shared folder members.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/list_folder_members/continue
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_folder_members/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFolderMembersContinueArg
cursor String The cursor returned by your last call to list_folder_members or list_folder_members/continue.
Returns
{
    "users": [
        {
            "access_type": {
                ".tag": "owner"
            },
            "user": {
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "same_team": true,
                "team_member_id": "dbmid:abcd1234"
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "groups": [
        {
            "access_type": {
                ".tag": "editor"
            },
            "group": {
                "group_name": "Test group",
                "group_id": "g:e2db7665347abcd600000000001a2b3c",
                "group_management_type": {
                    ".tag": "user_managed"
                },
                "group_type": {
                    ".tag": "user_managed"
                },
                "is_member": false,
                "is_owner": false,
                "same_team": true,
                "member_count": 10
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "invitees": [
        {
            "access_type": {
                ".tag": "viewer"
            },
            "invitee": {
                ".tag": "email",
                "email": "jessica@example.com"
            },
            "permissions": [],
            "is_inherited": false
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
SharedFolderMembers
Shared folder user and group membership.
users List of (UserMembershipInfo) The list of user members of the shared folder.
UserMembershipInfo
The information about a user member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
user UserInfo The account information for the membership user.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
groups List of (GroupMembershipInfo) The list of group members of the shared folder.
GroupMembershipInfo
The information about a group member of the shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
group GroupInfo The information about the membership group.
GroupInfo
The information about a group. Groups is a way to manage a list of users who need same access permission to the shared folder.
group_name String
group_id String
group_management_type GroupManagementType Who is allowed to manage the group.
GroupManagementType (open union)
The group type determines how a group is managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
company_managed Void A group which is managed by team admins only.
user_managed Void A group which is managed by selected users.
group_type GroupType The type of group.
GroupType (open union)
The group type determines how a group is created and managed. This datatype comes from an imported namespace originally defined in the team_common namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void A group to which team members are automatically added. Applicable to team folders only.
user_managed Void A group is created and managed by a user.
is_member Boolean If the current user is a member of the group.
is_owner Boolean If the current user is an owner of the group.
same_team Boolean If the group is owned by the current user's team.
group_external_id String? External ID of group. This is an arbitrary ID that an admin can attach to a group. This field is optional.
member_count UInt32? The number of members in the group. This field is optional.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
invitees List of (InviteeMembershipInfo) The list of invitees to the shared folder.
InviteeMembershipInfo
Information about an invited member of a shared content.
access_type AccessLevel The access type for this member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
invitee InviteeInfo Recipient of the invitation.
InviteeInfo (open union)
Information about the recipient of a shared content invitation. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of invited user.
permissions List of (MemberPermission)? The permissions that requesting user has on this member. The set of permissions corresponds to the MemberActions in the request. This field is optional.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
initials String? Suggested name initials for a member. This field is optional.
is_inherited Boolean True if the member has access from a parent folder. The default for this field is False.
user UserInfo? The user this invitation is tied to, if available. This field is optional.
UserInfo
Basic information about a user. Use users.get_account and users.get_account_batch to obtain more detailed information.
account_id String(min_length=40, max_length=40) The account ID of the user.
same_team Boolean If the user is in the same team as current user.
team_member_id String? The team member ID of the shared folder member. Only present if same_team is true. This field is optional.
cursor String? Present if there are additional shared folder members that have not been returned yet. Pass the cursor into list_folder_members/continue to list additional members. This field is optional.
Errors
Example: invalid_cursor 
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFolderMembersContinueError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
invalid_cursor Void ListFolderMembersContinueArg.cursor is invalid.

/list_folders

Description

Return the list of all shared folders the current user has access to.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/list_folders
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_folders \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"limit\": 100,\"actions\": []}"
Parameters
{
    "limit": 100,
    "actions": []
}
ListFoldersArgs
limit UInt32 The maximum number of results to return per request. The default for this field is 1000.
actions List of (FolderAction)? This is a list indicating whether each returned folder data entry will include a boolean field FolderPermission.allow that describes whether the current user can perform the `FolderAction` on the folder. This field is optional.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
Returns
{
    "entries": [
        {
            "access_type": {
                ".tag": "owner"
            },
            "is_team_folder": false,
            "policy": {
                "acl_update_policy": {
                    ".tag": "owner"
                },
                "shared_link_policy": {
                    ".tag": "anyone"
                },
                "member_policy": {
                    ".tag": "anyone"
                },
                "resolved_member_policy": {
                    ".tag": "team"
                }
            },
            "name": "dir",
            "shared_folder_id": "84528192421",
            "time_invited": "2016-01-20T00:00:00Z",
            "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
            "path_lower": "/dir",
            "permissions": []
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFoldersResult
Result for list_folders or list_mountable_folders, depending on which endpoint was requested.
Unmounted shared folders can be identified by the absence of SharedFolderMetadata.path_lower.
entries List of (SharedFolderMetadata) List of all shared folders the authenticated user has access to.
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
cursor String? Present if there are additional shared folders that have not been returned yet. Pass the cursor into the corresponding continue endpoint (either list_folders/continue or list_mountable_folders/continue) to list additional folders. This field is optional.
Errors

No errors.

/list_folders/continue

Description

Once a cursor has been retrieved from list_folders, use this to paginate through all shared folders. The cursor must come from a previous call to list_folders or list_folders/continue.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/list_folders/continue
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_folders/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFoldersContinueArg
cursor String The cursor returned by the previous API call specified in the endpoint description.
Returns
{
    "entries": [
        {
            "access_type": {
                ".tag": "owner"
            },
            "is_team_folder": false,
            "policy": {
                "acl_update_policy": {
                    ".tag": "owner"
                },
                "shared_link_policy": {
                    ".tag": "anyone"
                },
                "member_policy": {
                    ".tag": "anyone"
                },
                "resolved_member_policy": {
                    ".tag": "team"
                }
            },
            "name": "dir",
            "shared_folder_id": "84528192421",
            "time_invited": "2016-01-20T00:00:00Z",
            "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
            "path_lower": "/dir",
            "permissions": []
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFoldersResult
Result for list_folders or list_mountable_folders, depending on which endpoint was requested.
Unmounted shared folders can be identified by the absence of SharedFolderMetadata.path_lower.
entries List of (SharedFolderMetadata) List of all shared folders the authenticated user has access to.
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
cursor String? Present if there are additional shared folders that have not been returned yet. Pass the cursor into the corresponding continue endpoint (either list_folders/continue or list_mountable_folders/continue) to list additional folders. This field is optional.
Errors
Example: invalid_cursor 
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFoldersContinueError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_cursor Void ListFoldersContinueArg.cursor is invalid.

/list_mountable_folders

Description

Return the list of all shared folders the current user can mount or unmount.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/list_mountable_folders
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_mountable_folders \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"limit\": 100,\"actions\": []}"
Parameters
{
    "limit": 100,
    "actions": []
}
ListFoldersArgs
limit UInt32 The maximum number of results to return per request. The default for this field is 1000.
actions List of (FolderAction)? This is a list indicating whether each returned folder data entry will include a boolean field FolderPermission.allow that describes whether the current user can perform the `FolderAction` on the folder. This field is optional.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
Returns
{
    "entries": [
        {
            "access_type": {
                ".tag": "owner"
            },
            "is_team_folder": false,
            "policy": {
                "acl_update_policy": {
                    ".tag": "owner"
                },
                "shared_link_policy": {
                    ".tag": "anyone"
                },
                "member_policy": {
                    ".tag": "anyone"
                },
                "resolved_member_policy": {
                    ".tag": "team"
                }
            },
            "name": "dir",
            "shared_folder_id": "84528192421",
            "time_invited": "2016-01-20T00:00:00Z",
            "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
            "path_lower": "/dir",
            "permissions": []
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFoldersResult
Result for list_folders or list_mountable_folders, depending on which endpoint was requested.
Unmounted shared folders can be identified by the absence of SharedFolderMetadata.path_lower.
entries List of (SharedFolderMetadata) List of all shared folders the authenticated user has access to.
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
cursor String? Present if there are additional shared folders that have not been returned yet. Pass the cursor into the corresponding continue endpoint (either list_folders/continue or list_mountable_folders/continue) to list additional folders. This field is optional.
Errors

No errors.

/list_mountable_folders/continue

Description

Once a cursor has been retrieved from list_mountable_folders, use this to paginate through all mountable shared folders. The cursor must come from a previous call to list_mountable_folders or list_mountable_folders/continue.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/list_mountable_folders/continue
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_mountable_folders/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFoldersContinueArg
cursor String The cursor returned by the previous API call specified in the endpoint description.
Returns
{
    "entries": [
        {
            "access_type": {
                ".tag": "owner"
            },
            "is_team_folder": false,
            "policy": {
                "acl_update_policy": {
                    ".tag": "owner"
                },
                "shared_link_policy": {
                    ".tag": "anyone"
                },
                "member_policy": {
                    ".tag": "anyone"
                },
                "resolved_member_policy": {
                    ".tag": "team"
                }
            },
            "name": "dir",
            "shared_folder_id": "84528192421",
            "time_invited": "2016-01-20T00:00:00Z",
            "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
            "path_lower": "/dir",
            "permissions": []
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ListFoldersResult
Result for list_folders or list_mountable_folders, depending on which endpoint was requested.
Unmounted shared folders can be identified by the absence of SharedFolderMetadata.path_lower.
entries List of (SharedFolderMetadata) List of all shared folders the authenticated user has access to.
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
cursor String? Present if there are additional shared folders that have not been returned yet. Pass the cursor into the corresponding continue endpoint (either list_folders/continue or list_mountable_folders/continue) to list additional folders. This field is optional.
Errors
Example: invalid_cursor 
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFoldersContinueError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_cursor Void ListFoldersContinueArg.cursor is invalid.

/list_received_files

Description

Returns a list of all files shared with current user.
Does not include files the user has received via shared folders, and does not include unclaimed invitations.

URL Structure
https://api.dropboxapi.com/2/sharing/list_received_files
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_received_files \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"limit\": 100,\"actions\": []}"
Parameters
{
    "limit": 100,
    "actions": []
}
ListFilesArg
Arguments for list_received_files.
limit UInt32 Number of files to return max per query. Defaults to 100 if no limit is specified. The default for this field is 100.
actions List of (FileAction)? File actions to query. This field is optional.
FileAction (open union)
Sharing actions that may be taken on files. The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit_contents Void Change or edit contents of the file.
invite_viewer Void Add a member with view permissions.
invite_viewer_no_comment Void Add a member with view permissions but no comment permissions.
unshare Void Stop sharing this file.
relinquish_membership Void Relinquish one's own membership to the file.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link to the file.
Returns
{
    "entries": [
        {
            "policy": {
                "acl_update_policy": {
                    ".tag": "owner"
                },
                "shared_link_policy": {
                    ".tag": "anyone"
                },
                "member_policy": {
                    ".tag": "anyone"
                },
                "resolved_member_policy": {
                    ".tag": "team"
                }
            },
            "preview_url": "https://www.dropbox.com/scl/fi/fir9vjelf",
            "name": "file.txt",
            "id": "id:3kmLmQFnf1AAAAAAAAAAAw",
            "permissions": [],
            "owner_team": {
                "id": "dbtid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I",
                "name": "Acme, Inc."
            },
            "path_lower": "/dir/file.txt",
            "path_display": "/dir/file.txt",
            "time_invited": "2016-01-20T00:00:00Z"
        }
    ],
    "cursor": "AzJJbGlzdF90eXBdofe9c3RPbGlzdGFyZ3NfYnlfZ2lkMRhcbric7Rdog9cmV2aXNpb24H3Qf6o1fkHxQ"
}
ListFilesResult
Success results for list_received_files.
entries List of (SharedFileMetadata) Information about the files shared with current user.
SharedFileMetadata
Properties of the shared file.
policy FolderPolicy Policies governing this shared file.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
preview_url String URL for displaying a web preview of the shared file.
name String The name of this file.
id String(min_length=1, pattern="id:.*") The ID of the file.
permissions List of (FilePermission)? The sharing permissions that requesting user has on this file. This corresponds to the entries given in GetFileMetadataBatchArg.actions or GetFileMetadataArg.actions. This field is optional.
FilePermission
Whether the user is allowed to take the sharing action on the file.
action FileAction The action that the user may wish to take on the file.
FileAction (open union)
Sharing actions that may be taken on files. The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit_contents Void Change or edit contents of the file.
invite_viewer Void Add a member with view permissions.
invite_viewer_no_comment Void Add a member with view permissions but no comment permissions.
unshare Void Stop sharing this file.
relinquish_membership Void Relinquish one's own membership to the file.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link to the file.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
owner_team Team? The team that owns the file. This field is not present if the file is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the file is contained within a shared folder. This field is optional.
path_lower String? The lower-case full path of this file. Absent for unmounted files. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1. Absent for unmounted files. This field is optional.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Timestamp indicating when the current user was invited to this shared file. If the user was not invited to the shared file, the timestamp will indicate when the user was invited to the parent shared folder. This value may be absent. This field is optional.
cursor String? Cursor used to obtain additional shared files. This field is optional.
Errors
Example: email_unverified 
{
    "error_summary": "email_unverified/...",
    "error": {
        ".tag": "email_unverified"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.

/list_received_files/continue

Description

Get more results with a cursor from list_received_files.

URL Structure
https://api.dropboxapi.com/2/sharing/list_received_files/continue
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/list_received_files/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"AzJJbGlzdF90eXBdofe9c3RPbGlzdGFyZ3NfYnlfZ2lkMRhcbric7Rdog9emfGRlc2MCRWxpbWl0BGRId\"}"
Parameters
{
    "cursor": "AzJJbGlzdF90eXBdofe9c3RPbGlzdGFyZ3NfYnlfZ2lkMRhcbric7Rdog9emfGRlc2MCRWxpbWl0BGRId"
}
ListFilesContinueArg
Arguments for list_received_files/continue.
cursor String Cursor in ListFilesResult.cursor.
Returns
{
    "entries": [
        {
            "policy": {
                "acl_update_policy": {
                    ".tag": "owner"
                },
                "shared_link_policy": {
                    ".tag": "anyone"
                },
                "member_policy": {
                    ".tag": "anyone"
                },
                "resolved_member_policy": {
                    ".tag": "team"
                }
            },
            "preview_url": "https://www.dropbox.com/scl/fi/fir9vjelf",
            "name": "file.txt",
            "id": "id:3kmLmQFnf1AAAAAAAAAAAw",
            "permissions": [],
            "owner_team": {
                "id": "dbtid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I",
                "name": "Acme, Inc."
            },
            "path_lower": "/dir/file.txt",
            "path_display": "/dir/file.txt",
            "time_invited": "2016-01-20T00:00:00Z"
        }
    ],
    "cursor": "AzJJbGlzdF90eXBdofe9c3RPbGlzdGFyZ3NfYnlfZ2lkMRhcbric7Rdog9cmV2aXNpb24H3Qf6o1fkHxQ"
}
ListFilesResult
Success results for list_received_files.
entries List of (SharedFileMetadata) Information about the files shared with current user.
SharedFileMetadata
Properties of the shared file.
policy FolderPolicy Policies governing this shared file.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
preview_url String URL for displaying a web preview of the shared file.
name String The name of this file.
id String(min_length=1, pattern="id:.*") The ID of the file.
permissions List of (FilePermission)? The sharing permissions that requesting user has on this file. This corresponds to the entries given in GetFileMetadataBatchArg.actions or GetFileMetadataArg.actions. This field is optional.
FilePermission
Whether the user is allowed to take the sharing action on the file.
action FileAction The action that the user may wish to take on the file.
FileAction (open union)
Sharing actions that may be taken on files. The value will be one of the following datatypes. New values may be introduced as our API evolves.
edit_contents Void Change or edit contents of the file.
invite_viewer Void Add a member with view permissions.
invite_viewer_no_comment Void Add a member with view permissions but no comment permissions.
unshare Void Stop sharing this file.
relinquish_membership Void Relinquish one's own membership to the file.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link to the file.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
owner_team Team? The team that owns the file. This field is not present if the file is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the file is contained within a shared folder. This field is optional.
path_lower String? The lower-case full path of this file. Absent for unmounted files. This field is optional.
path_display String? The cased path to be used for display purposes only. In rare instances the casing will not correctly match the user's filesystem, but this behavior will match the path provided in the Core API v1. Absent for unmounted files. This field is optional.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Timestamp indicating when the current user was invited to this shared file. If the user was not invited to the shared file, the timestamp will indicate when the user was invited to the parent shared folder. This value may be absent. This field is optional.
cursor String? Cursor used to obtain additional shared files. This field is optional.
Errors
Example: invalid_cursor 
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListFilesContinueError (open union)
Error results for list_received_files/continue. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_error SharingUserError User account had a problem.
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.
invalid_cursor Void ListFilesContinueArg.cursor is invalid.

/mount_folder

Description

The current user mounts the designated folder.
Mount a shared folder for a user after they have been added as a member. Once mounted, the shared folder will appear in their Dropbox.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/mount_folder
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/mount_folder \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\"}"
Parameters
{
    "shared_folder_id": "84528192421"
}
MountFolderArg
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder to mount.
Returns
{
    "access_type": {
        ".tag": "owner"
    },
    "is_team_folder": false,
    "policy": {
        "acl_update_policy": {
            ".tag": "owner"
        },
        "shared_link_policy": {
            ".tag": "anyone"
        },
        "member_policy": {
            ".tag": "anyone"
        },
        "resolved_member_policy": {
            ".tag": "team"
        }
    },
    "name": "dir",
    "shared_folder_id": "84528192421",
    "time_invited": "2016-01-20T00:00:00Z",
    "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
    "path_lower": "/dir",
    "permissions": []
}
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
Example: inside_shared_folder 
{
    "error_summary": "inside_shared_folder/...",
    "error": {
        ".tag": "inside_shared_folder"
    }
}
Example: already_mounted 
{
    "error_summary": "already_mounted/...",
    "error": {
        ".tag": "already_mounted"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: not_mountable 
{
    "error_summary": "not_mountable/...",
    "error": {
        ".tag": "not_mountable"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
MountFolderError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
inside_shared_folder Void Mounting would cause a shared folder to be inside another, which is disallowed.
insufficient_quota InsufficientQuotaAmounts The current user does not have enough space to mount the shared folder.
InsufficientQuotaAmounts
space_needed UInt64 The amount of space needed to add the item (the size of the item).
space_shortage UInt64 The amount of extra space needed to add the item.
space_left UInt64 The amount of space left in the user's Dropbox, less than space_needed.
already_mounted Void The shared folder is already mounted.
no_permission Void The current user does not have permission to perform this action.
not_mountable Void The shared folder is not mountable. One example where this can occur is when the shared folder belongs within a team folder in the user's Dropbox.

/relinquish_file_membership

Description

The current user relinquishes their membership in the designated file. Note that the current user may still have inherited access to this file through the parent folder.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/relinquish_file_membership
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/relinquish_file_membership \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"file\": \"id:3kmLmQFnf1AAAAAAAAAAAw\"}"
Parameters
{
    "file": "id:3kmLmQFnf1AAAAAAAAAAAw"
}
RelinquishFileMembershipArg
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") The path or id for the file.
Returns

No return values.

Errors
Example: group_access 
{
    "error_summary": "group_access/...",
    "error": {
        ".tag": "group_access"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RelinquishFileMembershipError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharingFileAccessError
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
group_access Void The current user has access to the shared file via a group. You can't relinquish membership to a file shared via groups.
no_permission Void The current user does not have permission to perform this action.

/relinquish_folder_membership

Description

The current user relinquishes their membership in the designated shared folder and will no longer have access to the folder. A folder owner cannot relinquish membership in their own folder.
This will run synchronously if leave_a_copy is false, and asynchronously if leave_a_copy is true. Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/relinquish_folder_membership
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/relinquish_folder_membership \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\",\"leave_a_copy\": false}"
Parameters
{
    "shared_folder_id": "84528192421",
    "leave_a_copy": false
}
RelinquishFolderMembershipArg
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
leave_a_copy Boolean Keep a copy of the folder's contents upon relinquishing membership. The default for this field is False.
Returns
Example: complete 
{
    ".tag": "complete"
}
Example: async_job_id 
{
    ".tag": "async_job_id",
    "async_job_id": "34g93hh34h04y384084"
}
LaunchEmptyResult (union)
Result returned by methods that may either launch an asynchronous job or complete synchronously. Upon synchronous completion of the job, no additional information is returned. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes:
async_job_id String(min_length=1) This response indicates that the processing is asynchronous. The string is an id that can be used to obtain the status of the asynchronous job.
complete Void The job finished synchronously and successfully.
Errors
Example: folder_owner 
{
    "error_summary": "folder_owner/...",
    "error": {
        ".tag": "folder_owner"
    }
}
Example: mounted 
{
    "error_summary": "mounted/...",
    "error": {
        ".tag": "mounted"
    }
}
Example: group_access 
{
    "error_summary": "group_access/...",
    "error": {
        ".tag": "group_access"
    }
}
Example: team_folder 
{
    "error_summary": "team_folder/...",
    "error": {
        ".tag": "team_folder"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: no_explicit_access 
{
    "error_summary": "no_explicit_access/...",
    "error": {
        ".tag": "no_explicit_access"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RelinquishFolderMembershipError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
folder_owner Void The current user is the owner of the shared folder. Owners cannot relinquish membership to their own folders. Try unsharing or transferring ownership first.
mounted Void The shared folder is currently mounted. Unmount the shared folder before relinquishing membership.
group_access Void The current user has access to the shared folder via a group. You can't relinquish membership to folders shared via groups.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.
no_explicit_access Void The current user only has inherited access to the shared folder. You can't relinquish inherited membership to folders.

/remove_file_member

DEPRECATED BY /remove_file_member_2
Description

Identical to remove_file_member_2 but with less information returned.

URL Structure
https://api.dropboxapi.com/2/sharing/remove_file_member
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/remove_file_member \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"file\": \"id:3kmLmQFnf1AAAAAAAAAAAw\",\"member\": {\".tag\": \"email\",\"email\": \"justin@example.com\"}}"
Parameters
{
    "file": "id:3kmLmQFnf1AAAAAAAAAAAw",
    "member": {
        ".tag": "email",
        "email": "justin@example.com"
    }
}
RemoveFileMemberArg
Arguments for remove_file_member_2.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") File from which to remove members.
member MemberSelector Member to remove from this file. Note that even if an email is specified, it may result in the removal of a user (not an invitee) if the user's main account corresponds to that email address.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
Returns
{
    ".tag": "success"
}
FileMemberActionIndividualResult (union)
The value will be one of the following datatypes:
success AccessLevel? Member was successfully removed from this file. If AccessLevel is given, the member still has access via a parent shared folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
member_error FileMemberActionError User was not able to perform this action.
FileMemberActionError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_member Void Specified member was not found.
no_permission Void User does not have permission to perform this action on this member.
access_error SharingFileAccessError Specified file was invalid or user does not have access.
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
no_explicit_access MemberAccessLevelResult The action cannot be completed because the target member does not have explicit access to the file. The return value is the access that the member has to the file from a parent folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RemoveFileMemberError (open union)
Errors for remove_file_member_2. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_error SharingUserError
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.
access_error SharingFileAccessError
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
no_explicit_access MemberAccessLevelResult This member does not have explicit access to the file and therefore cannot be removed. The return value is the access that a user might have to the file from a parent folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.

/remove_file_member_2

Description

Removes a specified member from the file.

URL Structure
https://api.dropboxapi.com/2/sharing/remove_file_member_2
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/remove_file_member_2 \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"file\": \"id:3kmLmQFnf1AAAAAAAAAAAw\",\"member\": {\".tag\": \"email\",\"email\": \"justin@example.com\"}}"
Parameters
{
    "file": "id:3kmLmQFnf1AAAAAAAAAAAw",
    "member": {
        ".tag": "email",
        "email": "justin@example.com"
    }
}
RemoveFileMemberArg
Arguments for remove_file_member_2.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") File from which to remove members.
member MemberSelector Member to remove from this file. Note that even if an email is specified, it may result in the removal of a user (not an invitee) if the user's main account corresponds to that email address.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
Returns
{
    ".tag": "other"
}
FileMemberRemoveActionResult (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
success MemberAccessLevelResult Member was successfully removed from this file.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
member_error FileMemberActionError User was not able to remove this member.
FileMemberActionError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_member Void Specified member was not found.
no_permission Void User does not have permission to perform this action on this member.
access_error SharingFileAccessError Specified file was invalid or user does not have access.
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
no_explicit_access MemberAccessLevelResult The action cannot be completed because the target member does not have explicit access to the file. The return value is the access that the member has to the file from a parent folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RemoveFileMemberError (open union)
Errors for remove_file_member_2. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_error SharingUserError
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.
access_error SharingFileAccessError
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
no_explicit_access MemberAccessLevelResult This member does not have explicit access to the file and therefore cannot be removed. The return value is the access that a user might have to the file from a parent folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.

/remove_folder_member

Description

Allows an owner or editor (if the ACL update policy allows) of a shared folder to remove another member.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/remove_folder_member
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/remove_folder_member \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\",\"member\": {\".tag\": \"email\",\"email\": \"justin@example.com\"},\"leave_a_copy\": false}"
Parameters
{
    "shared_folder_id": "84528192421",
    "member": {
        ".tag": "email",
        "email": "justin@example.com"
    },
    "leave_a_copy": false
}
RemoveFolderMemberArg
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
member MemberSelector The member to remove from the folder.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
leave_a_copy Boolean If true, the removed user will keep their copy of the folder after it's unshared, assuming it was mounted. Otherwise, it will be removed from their Dropbox. Also, this must be set to false when kicking a group.
Returns
LaunchResultBase (union)
Result returned by methods that launch an asynchronous job.
A method who may either launch an asynchronous job, or complete the request synchronously, can use this union by extending it, and adding a 'complete' field with the type of the synchronous response.
See LaunchEmptyResult for an example. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes:
async_job_id String(min_length=1) This response indicates that the processing is asynchronous. The string is an id that can be used to obtain the status of the asynchronous job.
Errors
Example: folder_owner 
{
    "error_summary": "folder_owner/...",
    "error": {
        ".tag": "folder_owner"
    }
}
Example: group_access 
{
    "error_summary": "group_access/...",
    "error": {
        ".tag": "group_access"
    }
}
Example: team_folder 
{
    "error_summary": "team_folder/...",
    "error": {
        ".tag": "team_folder"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RemoveFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
member_error SharedFolderMemberError
SharedFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_dropbox_id Void The target dropbox_id is invalid.
not_a_member Void The target dropbox_id is not a member of the shared folder.
no_explicit_access MemberAccessLevelResult The target member only has inherited access to the shared folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
folder_owner Void The target user is the owner of the shared folder. You can't remove this user until ownership has been transferred to another member.
group_access Void The target user has access to the shared folder via a group.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.

/share_folder

Description

Share a folder with collaborators.
Most sharing will be completed synchronously. Large folders will be completed asynchronously. To make testing the async case repeatable, set `ShareFolderArg.force_async`.
If a ShareFolderLaunch.async_job_id is returned, you'll need to call check_share_job_status until the action completes to get the metadata for the folder.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/share_folder
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/share_folder \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/example/workspace\",\"member_policy\": \"team\",\"acl_update_policy\": \"editors\",\"shared_link_policy\": \"members\",\"force_async\": false}"
Parameters
{
    "path": "/example/workspace",
    "member_policy": "team",
    "acl_update_policy": "editors",
    "shared_link_policy": "members",
    "force_async": false
}
ShareFolderArg
path String(pattern="(/(.|[\r\n])*)|(ns:[0-9]+(/.*)?)") The path to the folder to share. If it does not exist, then a new one is created.
member_policy MemberPolicy Who can be a member of this shared folder. Only applicable if the current user is on a team. The default for this union is anyone.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
acl_update_policy AclUpdatePolicy Who can add and remove members of this shared folder. The default for this union is owner.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy The policy to apply to shared links created for content inside this shared folder. The current user must be on a team to set this policy to SharedLinkPolicy.members. The default for this union is anyone.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
force_async Boolean Whether to force the share to happen asynchronously. The default for this field is False.
Returns
{
    ".tag": "complete",
    "access_type": {
        ".tag": "owner"
    },
    "is_team_folder": false,
    "policy": {
        "acl_update_policy": {
            ".tag": "owner"
        },
        "shared_link_policy": {
            ".tag": "anyone"
        },
        "member_policy": {
            ".tag": "anyone"
        },
        "resolved_member_policy": {
            ".tag": "team"
        }
    },
    "name": "dir",
    "shared_folder_id": "84528192421",
    "time_invited": "2016-01-20T00:00:00Z",
    "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
    "path_lower": "/dir",
    "permissions": []
}
ShareFolderLaunch (union)
The value will be one of the following datatypes:
async_job_id String(min_length=1) This response indicates that the processing is asynchronous. The string is an id that can be used to obtain the status of the asynchronous job.
complete SharedFolderMetadata
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
Example: email_unverified 
{
    "error_summary": "email_unverified/...",
    "error": {
        ".tag": "email_unverified"
    }
}
Example: team_policy_disallows_member_policy 
{
    "error_summary": "team_policy_disallows_member_policy/...",
    "error": {
        ".tag": "team_policy_disallows_member_policy"
    }
}
Example: disallowed_shared_link_policy 
{
    "error_summary": "disallowed_shared_link_policy/...",
    "error": {
        ".tag": "disallowed_shared_link_policy"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
ShareFolderError (union)
The value will be one of the following datatypes:
email_unverified Void The current user's e-mail address is unverified.
bad_path SharePathError ShareFolderArg.path is invalid.
SharePathError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
is_file Void A file is at the specified path.
inside_shared_folder Void We do not support sharing a folder inside a shared folder.
contains_shared_folder Void We do not support shared folders that contain shared folders.
contains_app_folder Void We do not support shared folders that contain app folders.
contains_team_folder Void We do not support shared folders that contain team folders.
is_app_folder Void We do not support sharing an app folder.
inside_app_folder Void We do not support sharing a folder inside an app folder.
is_public_folder Void A public folder can't be shared this way. Use a public link instead.
inside_public_folder Void A folder inside a public folder can't be shared this way. Use a public link instead.
already_shared SharedFolderMetadata Folder is already shared. Contains metadata about the existing shared folder.
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
invalid_path Void Path is not valid.
is_osx_package Void We do not support sharing a Mac OS X package.
inside_osx_package Void We do not support sharing a folder inside a Mac OS X package.
invalid_path_root PathRootError The path root parameter provided is invalid.
PathRootError
This datatype comes from an imported namespace originally defined in the files namespace.
path_root String? The user's latest path root value. None if the user no longer has a path root. This field is optional.
team_policy_disallows_member_policy Void Team policy is more restrictive than ShareFolderArg.member_policy.
disallowed_shared_link_policy Void The current user's account is not allowed to select the specified ShareFolderArg.shared_link_policy.
no_permission Void The current user does not have permission to perform this action.

/transfer_folder

Description

Transfer ownership of a shared folder to a member of the shared folder.
User must have AccessLevel.owner access to the shared folder to perform a transfer.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/transfer_folder
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/transfer_folder \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\",\"to_dropbox_id\": \"dbid:AAEufNrMPSPe0dMQijRP0N_aZtBJRm26W4Q\"}"
Parameters
{
    "shared_folder_id": "84528192421",
    "to_dropbox_id": "dbid:AAEufNrMPSPe0dMQijRP0N_aZtBJRm26W4Q"
}
TransferFolderArg
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
to_dropbox_id String(min_length=1) A account or team member ID to transfer ownership to.
Returns

No return values.

Errors
Example: invalid_dropbox_id 
{
    "error_summary": "invalid_dropbox_id/...",
    "error": {
        ".tag": "invalid_dropbox_id"
    }
}
Example: new_owner_not_a_member 
{
    "error_summary": "new_owner_not_a_member/...",
    "error": {
        ".tag": "new_owner_not_a_member"
    }
}
Example: new_owner_unmounted 
{
    "error_summary": "new_owner_unmounted/...",
    "error": {
        ".tag": "new_owner_unmounted"
    }
}
Example: new_owner_email_unverified 
{
    "error_summary": "new_owner_email_unverified/...",
    "error": {
        ".tag": "new_owner_email_unverified"
    }
}
Example: team_folder 
{
    "error_summary": "team_folder/...",
    "error": {
        ".tag": "team_folder"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TransferFolderError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
invalid_dropbox_id Void TransferFolderArg.to_dropbox_id is invalid.
new_owner_not_a_member Void The new designated owner is not currently a member of the shared folder.
new_owner_unmounted Void The new designated owner has not added the folder to their Dropbox.
new_owner_email_unverified Void The new designated owner's e-mail address is unverified.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.

/unmount_folder

Description

The current user unmounts the designated folder. They can re-mount the folder at a later time using mount_folder.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/unmount_folder
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/unmount_folder \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\"}"
Parameters
{
    "shared_folder_id": "84528192421"
}
UnmountFolderArg
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
Returns

No return values.

Errors
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: not_unmountable 
{
    "error_summary": "not_unmountable/...",
    "error": {
        ".tag": "not_unmountable"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
UnmountFolderError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
no_permission Void The current user does not have permission to perform this action.
not_unmountable Void The shared folder can't be unmounted. One example where this can occur is when the shared folder's parent folder is also a shared folder that resides in the current user's Dropbox.

/unshare_file

Description

Remove all members from this file. Does not remove inherited members.

URL Structure
https://api.dropboxapi.com/2/sharing/unshare_file
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/unshare_file \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"file\": \"id:3kmLmQFnf1AAAAAAAAAAAw\"}"
Parameters
{
    "file": "id:3kmLmQFnf1AAAAAAAAAAAw"
}
UnshareFileArg
Arguments for unshare_file.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") The file to unshare.
Returns

No return values.

Errors
{
    "error_summary": "user_error/email_unverified/...",
    "error": {
        ".tag": "user_error",
        "user_error": {
            ".tag": "email_unverified"
        }
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
UnshareFileError (open union)
Error result for unshare_file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_error SharingUserError
SharingUserError (open union)
User account had a problem preventing this action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
email_unverified Void The current user must verify the account e-mail address before performing this action.
access_error SharingFileAccessError
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.

/unshare_folder

Description

Allows a shared folder owner to unshare the folder.
You'll need to call check_job_status to determine if the action has completed successfully.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/unshare_folder
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/unshare_folder \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\",\"leave_a_copy\": false}"
Parameters
{
    "shared_folder_id": "84528192421",
    "leave_a_copy": false
}
UnshareFolderArg
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
leave_a_copy Boolean If true, members of this shared folder will get a copy of this folder after it's unshared. Otherwise, it will be removed from their Dropbox. The current user, who is an owner, will always retain their copy. The default for this field is False.
Returns
Example: complete 
{
    ".tag": "complete"
}
Example: async_job_id 
{
    ".tag": "async_job_id",
    "async_job_id": "34g93hh34h04y384084"
}
LaunchEmptyResult (union)
Result returned by methods that may either launch an asynchronous job or complete synchronously. Upon synchronous completion of the job, no additional information is returned. This datatype comes from an imported namespace originally defined in the async namespace. The value will be one of the following datatypes:
async_job_id String(min_length=1) This response indicates that the processing is asynchronous. The string is an id that can be used to obtain the status of the asynchronous job.
complete Void The job finished synchronously and successfully.
Errors
Example: team_folder 
{
    "error_summary": "team_folder/...",
    "error": {
        ".tag": "team_folder"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: too_many_files 
{
    "error_summary": "too_many_files/...",
    "error": {
        ".tag": "too_many_files"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
UnshareFolderError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.
too_many_files Void This shared folder has too many files to be unshared.

/update_file_member

Description

Changes a member's access on a shared file.

URL Structure
https://api.dropboxapi.com/2/sharing/update_file_member
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/update_file_member \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"file\": \"id:3kmLmQFnf1AAAAAAAAAAAw\",\"member\": {\".tag\": \"email\",\"email\": \"justin@example.com\"},\"access_level\": \"viewer\"}"
Parameters
{
    "file": "id:3kmLmQFnf1AAAAAAAAAAAw",
    "member": {
        ".tag": "email",
        "email": "justin@example.com"
    },
    "access_level": "viewer"
}
UpdateFileMemberArgs
Arguments for update_file_member.
file String(min_length=1, pattern="((/|id:).*|nspath:[0-9]+:.*)|ns:[0-9]+(/.*)?") File for which we are changing a member's access.
member MemberSelector The member whose access we are changing.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
access_level AccessLevel The new access level for the member.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
Returns
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
Example: invalid_member 
{
    "error_summary": "invalid_member/...",
    "error": {
        ".tag": "invalid_member"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
FileMemberActionError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_member Void Specified member was not found.
no_permission Void User does not have permission to perform this action on this member.
access_error SharingFileAccessError Specified file was invalid or user does not have access.
SharingFileAccessError (open union)
User could not access this file. The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_permission Void Current user does not have sufficient privileges to perform the desired action.
invalid_file Void File specified was not found.
is_folder Void A folder can't be shared this way. Use folder sharing or a shared link instead.
inside_public_folder Void A file inside a public folder can't be shared this way. Use a public link instead.
inside_osx_package Void A Mac OS X package can't be shared this way. Use a shared link instead.
no_explicit_access MemberAccessLevelResult The action cannot be completed because the target member does not have explicit access to the file. The return value is the access that the member has to the file from a parent folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.

/update_folder_member

Description

Allows an owner or editor of a shared folder to update another member's permissions.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/update_folder_member
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/update_folder_member \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\",\"member\": {\".tag\": \"email\",\"email\": \"justin@example.com\"},\"access_level\": \"editor\"}"
Parameters
{
    "shared_folder_id": "84528192421",
    "member": {
        ".tag": "email",
        "email": "justin@example.com"
    },
    "access_level": "editor"
}
UpdateFolderMemberArg
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
member MemberSelector The member of the shared folder to update. Only the MemberSelector.dropbox_id may be set at this time.
MemberSelector (open union)
Includes different ways to identify a member of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
dropbox_id String(min_length=1) Dropbox account, team member, or group ID of member.
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") E-mail address of member.
access_level AccessLevel The new access level for member. AccessLevel.owner is disallowed.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
Returns
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
Example: insufficient_plan 
{
    "error_summary": "insufficient_plan/...",
    "error": {
        ".tag": "insufficient_plan"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
UpdateFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
member_error SharedFolderMemberError
SharedFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_dropbox_id Void The target dropbox_id is invalid.
not_a_member Void The target dropbox_id is not a member of the shared folder.
no_explicit_access MemberAccessLevelResult The target member only has inherited access to the shared folder.
MemberAccessLevelResult
Contains information about a member's access level to content after an operation.
access_level AccessLevel? The member still has this level of access to the content through a parent folder. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
warning String? A localized string with additional information about why the user has this access level to the content. This field is optional.
access_details List of (ParentFolderAccessInfo)? The parent folders that a member has access to. The field is present if the user has access to the first parent folder where the member gains access. This field is optional.
ParentFolderAccessInfo
Contains information about a parent folder that a member has access to.
folder_name String Display name for the folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The identifier of the parent shared folder.
permissions List of (MemberPermission) The user's permissions for the parent shared folder.
MemberPermission
Whether the user is allowed to take the action on the associated member.
action MemberAction The action that the user may wish to take on the member.
MemberAction (open union)
Actions that may be taken on members of a shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
leave_a_copy Void Allow the member to keep a copy of the folder when removing.
make_editor Void Make the member an editor of the folder.
make_owner Void Make the member an owner of the folder.
make_viewer Void Make the member a viewer of the folder.
make_viewer_no_comment Void Make the member a viewer of the folder without commenting permissions.
remove Void Remove the member from the folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
no_explicit_access AddFolderMemberError If updating the access type required the member to be added to the shared folder and there was an error when adding the member.
AddFolderMemberError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError Unable to access shared folder.
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
email_unverified Void The current user's e-mail address is unverified.
bad_member AddMemberSelectorError AddFolderMemberArg.members contains a bad invitation recipient.
AddMemberSelectorError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
automatic_group Void Automatically created groups can only be added to team folders.
invalid_dropbox_id String(min_length=1) The value is the ID that could not be identified.
invalid_email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") The value is the e-email address that is malformed.
unverified_dropbox_id String(min_length=1) The value is the ID of the Dropbox user with an unverified e-mail address. Invite unverified users by e-mail address instead of by their Dropbox ID.
group_deleted Void At least one of the specified groups in AddFolderMemberArg.members is deleted.
group_not_on_team Void Sharing to a group that is not on the current user's team.
cant_share_outside_team Void Your team policy does not allow sharing outside of the team.
too_many_members UInt64 The value is the member limit that was reached.
too_many_pending_invites UInt64 The value is the pending invite limit that was reached.
rate_limit Void The current user has hit the limit of invites they can send per day. Try again in 24 hours.
too_many_invitees Void The current user is trying to share with too many people at once.
insufficient_plan Void The current user's account doesn't support this action. An example of this is when adding a read-only member. This action can only be performed by users that have upgraded to a Pro or Business plan.
team_folder Void This action cannot be performed on a team shared folder.
no_permission Void The current user does not have permission to perform this action.
insufficient_plan Void The current user's account doesn't support this action. An example of this is when downgrading a member from editor to viewer. This action can only be performed by users that have upgraded to a Pro or Business plan.
no_permission Void The current user does not have permission to perform this action.

/update_folder_policy

Description

Update the sharing policies for a shared folder.
User must have AccessLevel.owner access to the shared folder to update its policies.
Apps must have full Dropbox access to use this endpoint.

URL Structure
https://api.dropboxapi.com/2/sharing/update_folder_policy
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/sharing/update_folder_policy \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"shared_folder_id\": \"84528192421\",\"member_policy\": \"team\",\"acl_update_policy\": \"owner\",\"shared_link_policy\": \"members\"}"
Parameters
{
    "shared_folder_id": "84528192421",
    "member_policy": "team",
    "acl_update_policy": "owner",
    "shared_link_policy": "members"
}
UpdateFolderPolicyArg
If any of the policy's are unset, then they retain their current setting.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID for the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder. Only applicable if the current user is on a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
acl_update_policy AclUpdatePolicy? Who can add and remove members of this shared folder. This field is optional.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy? The policy to apply to shared links created for content inside this shared folder. The current user must be on a team to set this policy to SharedLinkPolicy.members. This field is optional.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
Returns
{
    "access_type": {
        ".tag": "owner"
    },
    "is_team_folder": false,
    "policy": {
        "acl_update_policy": {
            ".tag": "owner"
        },
        "shared_link_policy": {
            ".tag": "anyone"
        },
        "member_policy": {
            ".tag": "anyone"
        },
        "resolved_member_policy": {
            ".tag": "team"
        }
    },
    "name": "dir",
    "shared_folder_id": "84528192421",
    "time_invited": "2016-01-20T00:00:00Z",
    "preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
    "path_lower": "/dir",
    "permissions": []
}
SharedFolderMetadata
The metadata which includes basic information about the shared folder.
access_type AccessLevel The current user's access level for this shared folder.
AccessLevel (open union)
Defines the access levels for collaborators. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void The collaborator is the owner of the shared folder. Owners can view and edit the shared folder as well as set the folder's policies using update_folder_policy.
editor Void The collaborator can both view and edit the shared folder.
viewer Void The collaborator can only view the shared folder.
viewer_no_comment Void The collaborator can only view the shared folder and does not have any access to comments.
is_team_folder Boolean Whether this folder is a team folder.
policy FolderPolicy Policies governing this shared folder.
FolderPolicy
A set of policies governing membership and privileges for a shared folder.
acl_update_policy AclUpdatePolicy Who can add and remove members from this shared folder.
AclUpdatePolicy (open union)
Policy governing who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void Only the owner can update the ACL.
editors Void Any editor can update the ACL. This may be further restricted to editors on the same team.
shared_link_policy SharedLinkPolicy Who links can be shared with.
SharedLinkPolicy (open union)
Policy governing who can view shared links. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone Void Links can be shared with anyone.
members Void Links can only be shared among members of the shared folder.
member_policy MemberPolicy? Who can be a member of this shared folder, as set on the folder itself. The effective policy may differ from this value if the team-wide policy is more restrictive. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
resolved_member_policy MemberPolicy? Who can be a member of this shared folder, taking into account both the folder and the team-wide policy. This value may differ from that of member_policy if the team-wide policy is more restrictive than the folder policy. Present only if the folder is owned by a team. This field is optional.
MemberPolicy (open union)
Policy governing who can be a member of a shared folder. Only applicable to folders owned by a user on a team. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
name String The name of the this shared folder.
shared_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the shared folder.
time_invited Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Timestamp indicating when the current user was invited to this shared folder.
preview_url String URL for displaying a web preview of the shared folder.
owner_team Team? The team that owns the folder. This field is not present if the folder is not owned by a team. This field is optional.
Team
Information about a team. This datatype comes from an imported namespace originally defined in the users namespace.
id String The team's unique ID.
name String The name of the team.
parent_shared_folder_id String(pattern="[-_0-9a-zA-Z:]+")? The ID of the parent shared folder. This field is present only if the folder is contained within another shared folder. This field is optional.
path_lower String? The lower-cased full path of this shared folder. Absent for unmounted folders. This field is optional.
permissions List of (FolderPermission)? Actions the current user may perform on the folder and its contents. The set of permissions corresponds to the FolderActions in the request. This field is optional.
FolderPermission
Whether the user is allowed to take the action on the shared folder.
action FolderAction The action that the user may wish to take on the folder.
FolderAction (open union)
Actions that may be taken on shared folders. The value will be one of the following datatypes. New values may be introduced as our API evolves.
change_options Void Change folder options, such as who can be invited to join the folder.
edit_contents Void Change or edit contents of the folder.
invite_editor Void Invite a user or group to join the folder with read and write permission.
invite_viewer Void Invite a user or group to join the folder with read permission.
invite_viewer_no_comment Void Invite a user or group to join the folder with read permission but no comment permissions.
relinquish_membership Void Relinquish one's own membership in the folder.
unmount Void Unmount the folder.
unshare Void Stop sharing this folder.
leave_a_copy Void Keep a copy of the contents upon leaving or being kicked from the folder.
share_link Void This action is deprecated. Use create_link instead.
create_link Void Create a shared link for folder.
allow Boolean True if the user is allowed to take the action.
reason PermissionDeniedReason? The reason why the user is denied the permission. Not present if the action is allowed, or if no reason is available. This field is optional.
PermissionDeniedReason (open union)
Possible reasons the user is denied a permission. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_same_team_as_owner Void User is not on the same team as the folder owner.
user_not_allowed_by_owner Void User is prohibited by the owner from taking the action.
target_is_indirect_member Void Target is indirectly a member of the folder, for example by being part of a group.
target_is_owner Void Target is the owner of the folder.
target_is_self Void Target is the user itself.
target_not_active Void Target is not an active member of the team.
folder_is_limited_team_folder Void Folder is team folder for a limited team.
Errors
Example: not_on_team 
{
    "error_summary": "not_on_team/...",
    "error": {
        ".tag": "not_on_team"
    }
}
Example: team_policy_disallows_member_policy 
{
    "error_summary": "team_policy_disallows_member_policy/...",
    "error": {
        ".tag": "team_policy_disallows_member_policy"
    }
}
Example: disallowed_shared_link_policy 
{
    "error_summary": "disallowed_shared_link_policy/...",
    "error": {
        ".tag": "disallowed_shared_link_policy"
    }
}
Example: no_permission 
{
    "error_summary": "no_permission/...",
    "error": {
        ".tag": "no_permission"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
UpdateFolderPolicyError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
access_error SharedFolderAccessError
SharedFolderAccessError (open union)
There is an error accessing the shared folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_id Void This shared folder ID is invalid.
not_a_member Void The user is not a member of the shared folder thus cannot access it.
email_unverified Void The current user's e-mail address is unverified.
unmounted Void The shared folder is unmounted.
not_on_team Void UpdateFolderPolicyArg.member_policy was set even though user is not on a team.
team_policy_disallows_member_policy Void Team policy is more restrictive than ShareFolderArg.member_policy.
disallowed_shared_link_policy Void The current account is not allowed to select the specified ShareFolderArg.shared_link_policy.
no_permission Void The current user does not have permission to perform this action.

users

This namespace contains endpoints and data types for user management.

/get_account

Description

Get information about a user's account.

URL Structure
https://api.dropboxapi.com/2/users/get_account
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/users/get_account \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"account_id\": \"dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc\"}"
Parameters
{
    "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
}
GetAccountArg
account_id String(min_length=40, max_length=40) A user's account identifier.
Returns
{
    "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
    "name": {
        "given_name": "Franz",
        "surname": "Ferdinand",
        "familiar_name": "Franz",
        "display_name": "Franz Ferdinand (Personal)",
        "abbreviated_name": "FF"
    },
    "email": "franz@dropbox.com",
    "email_verified": true,
    "disabled": false,
    "is_teammate": false,
    "profile_photo_url": "https://dl-web.dropbox.com/account_photo/get/dbid%3AAAH4f99T0taONIb-OurWxbNQ6ywGRopQngc?vers=1453416696524&size=128x128"
}
Example: team 
{
    "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
    "name": {
        "given_name": "Franz",
        "surname": "Ferdinand",
        "familiar_name": "Franz",
        "display_name": "Franz Ferdinand (Personal)",
        "abbreviated_name": "FF"
    },
    "email": "franz@dropbox.com",
    "email_verified": true,
    "disabled": false,
    "is_teammate": true,
    "profile_photo_url": "https://dl-web.dropbox.com/account_photo/get/dbid%3AAAH4f99T0taONIb-OurWxbNQ6ywGRopQngc?vers=1453416696524&size=128x128",
    "team_member_id": "dbmid:AAHhy7WsR0x-u4ZCqiDl5Fz5zvuL3kmspwU"
}
BasicAccount
Basic information about any account.
account_id String(min_length=40, max_length=40) The user's unique Dropbox ID.
name Name Details of a user's name.
Name
Representations for a person's name to assist with internationalization.
given_name String Also known as a first name.
surname String Also known as a last name or family name.
familiar_name String Locale-dependent name. In the US, a person's familiar name is their given_name, but elsewhere, it could be any combination of a person's given_name and surname.
display_name String A name that can be used directly to represent the name of a user's Dropbox account.
abbreviated_name String An abbreviated form of the person's name. Their initials in most locales.
email String The user's e-mail address. Do not rely on this without checking the email_verified field. Even then, it's possible that the user has since lost access to their e-mail.
email_verified Boolean Whether the user has verified their e-mail address.
disabled Boolean Whether the user has been disabled.
is_teammate Boolean Whether this user is a teammate of the current user. If this account is the current user's account, then this will be true.
profile_photo_url String? URL for the photo representing the user, if one is set. This field is optional.
team_member_id String? The user's unique team member id. This field will only be present if the user is part of a team and is_teammate is true. This field is optional.
Errors
Example: no_account 
{
    "error_summary": "no_account/...",
    "error": {
        ".tag": "no_account"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GetAccountError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_account Void The specified GetAccountArg.account_id does not exist.

/get_account_batch

Description

Get information about multiple user accounts. At most 300 accounts may be queried per request.

URL Structure
https://api.dropboxapi.com/2/users/get_account_batch
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/users/get_account_batch \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"account_ids\": [\"dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc\",\"dbid:AAH1Vcz-DVoRDeixtr_OA8oUGgiqhs4XPOQ\"]}"
Parameters
{
    "account_ids": [
        "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
        "dbid:AAH1Vcz-DVoRDeixtr_OA8oUGgiqhs4XPOQ"
    ]
}
GetAccountBatchArg
account_ids List of (String(min_length=40, max_length=40), min_items=1) List of user account identifiers. Should not contain any duplicate account IDs.
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
BasicAccount
Basic information about any account.
account_id String(min_length=40, max_length=40) The user's unique Dropbox ID.
name Name Details of a user's name.
Name
Representations for a person's name to assist with internationalization.
given_name String Also known as a first name.
surname String Also known as a last name or family name.
familiar_name String Locale-dependent name. In the US, a person's familiar name is their given_name, but elsewhere, it could be any combination of a person's given_name and surname.
display_name String A name that can be used directly to represent the name of a user's Dropbox account.
abbreviated_name String An abbreviated form of the person's name. Their initials in most locales.
email String The user's e-mail address. Do not rely on this without checking the email_verified field. Even then, it's possible that the user has since lost access to their e-mail.
email_verified Boolean Whether the user has verified their e-mail address.
disabled Boolean Whether the user has been disabled.
is_teammate Boolean Whether this user is a teammate of the current user. If this account is the current user's account, then this will be true.
profile_photo_url String? URL for the photo representing the user, if one is set. This field is optional.
team_member_id String? The user's unique team member id. This field will only be present if the user is part of a team and is_teammate is true. This field is optional.
Errors
{
    "error_summary": "no_account/...",
    "error": {
        ".tag": "no_account",
        "no_account": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"
    }
}
Example: other 
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GetAccountBatchError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
no_account String(min_length=40, max_length=40) The value is an account ID specified in GetAccountBatchArg.account_ids that does not exist.

/get_current_account

Description

Get information about the current user's account.

URL Structure
https://api.dropboxapi.com/2/users/get_current_account
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/users/get_current_account \
    --header "Authorization: Bearer "
Parameters

No parameters.

Returns
Example: Paired account 
{
    "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
    "name": {
        "given_name": "Franz",
        "surname": "Ferdinand",
        "familiar_name": "Franz",
        "display_name": "Franz Ferdinand (Personal)",
        "abbreviated_name": "FF"
    },
    "email": "franz@dropbox.com",
    "email_verified": true,
    "disabled": false,
    "locale": "en",
    "referral_link": "https://db.tt/ZITNuhtI",
    "is_paired": true,
    "account_type": {
        ".tag": "business"
    },
    "country": "US",
    "team": {
        "id": "dbtid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I",
        "name": "Acme, Inc.",
        "sharing_policies": {
            "shared_folder_member_policy": {
                ".tag": "team"
            },
            "shared_folder_join_policy": {
                ".tag": "from_anyone"
            },
            "shared_link_create_policy": {
                ".tag": "team_only"
            }
        }
    },
    "team_member_id": "dbmid:AAHhy7WsR0x-u4ZCqiDl5Fz5zvuL3kmspwU"
}
Example: A personal account that is not paired with a team. 
{
    "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
    "name": {
        "given_name": "Franz",
        "surname": "Ferdinand",
        "familiar_name": "Franz",
        "display_name": "Franz Ferdinand (Personal)",
        "abbreviated_name": "FF"
    },
    "email": "franz@gmail.com",
    "email_verified": false,
    "disabled": false,
    "locale": "en",
    "referral_link": "https://db.tt/ZITNuhtI",
    "is_paired": false,
    "account_type": {
        ".tag": "basic"
    },
    "profile_photo_url": "https://dl-web.dropbox.com/account_photo/get/dbid%3AAAH4f99T0taONIb-OurWxbNQ6ywGRopQngc?vers=1453416673259&size=128x128",
    "country": "US"
}
FullAccount
Detailed information about the current user's account.
account_id String(min_length=40, max_length=40) The user's unique Dropbox ID.
name Name Details of a user's name.
Name
Representations for a person's name to assist with internationalization.
given_name String Also known as a first name.
surname String Also known as a last name or family name.
familiar_name String Locale-dependent name. In the US, a person's familiar name is their given_name, but elsewhere, it could be any combination of a person's given_name and surname.
display_name String A name that can be used directly to represent the name of a user's Dropbox account.
abbreviated_name String An abbreviated form of the person's name. Their initials in most locales.
email String The user's e-mail address. Do not rely on this without checking the email_verified field. Even then, it's possible that the user has since lost access to their e-mail.
email_verified Boolean Whether the user has verified their e-mail address.
disabled Boolean Whether the user has been disabled.
locale String(min_length=2) The language that the user specified. Locale tags will be IETF language tags.
referral_link String The user's referral link.
is_paired Boolean Whether the user has a personal and work account. If the current account is personal, then team will always be None, but is_paired will indicate if a work account is linked.
account_type AccountType What type of account this user has.
AccountType (union)
What type of account this user has. The value will be one of the following datatypes:
basic Void The basic account type.
pro Void The Dropbox Pro account type.
business Void The Dropbox Business account type.
profile_photo_url String? URL for the photo representing the user, if one is set. This field is optional.
country String(min_length=2, max_length=2)? The user's two-letter country code, if available. Country codes are based on ISO 3166-1. This field is optional.
team FullTeam? If this account is a member of a team, information about that team. This field is optional.
FullTeam
Detailed information about a team.
id String The team's unique ID.
name String The name of the team.
sharing_policies TeamSharingPolicies Team policies governing sharing.
TeamSharingPolicies
Policies governing sharing within and outside of the team. This datatype comes from an imported namespace originally defined in the team_policies namespace.
shared_folder_member_policy SharedFolderMemberPolicy Who can join folders shared by team members.
SharedFolderMemberPolicy (open union)
Policy governing who can be a member of a folder shared by a team member. This datatype comes from an imported namespace originally defined in the team_policies namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team Void Only a teammate can be a member of a folder shared by a team member.
anyone Void Anyone can be a member of a folder shared by a team member.
shared_folder_join_policy SharedFolderJoinPolicy Which shared folders team members can join.
SharedFolderJoinPolicy (open union)
Policy governing which shared folders a team member can join. This datatype comes from an imported namespace originally defined in the team_policies namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
from_team_only Void Team members can only join folders shared by teammates.
from_anyone Void Team members can join any shared folder, including those shared by users outside the team.
shared_link_create_policy SharedLinkCreatePolicy What is the visibility of newly created shared links.
SharedLinkCreatePolicy (open union)
Policy governing the visibility of newly created shared links. This datatype comes from an imported namespace originally defined in the team_policies namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default_public Void By default, anyone can access newly created shared links. No login will be required to access the shared links unless overridden.
default_team_only Void By default, only members of the same team can access newly created shared links. Login will be required to access the shared links unless overridden.
team_only Void Only members of the same team can access newly created shared links. Login will be required to access the shared links.
team_member_id String? This account's unique team member id. This field will only be present if team is present. This field is optional.
Errors

No errors.

/get_space_usage

Description

Get the space usage information for the current user's account.

URL Structure
https://api.dropboxapi.com/2/users/get_space_usage
Authentication
User Authentication
Endpoint format
RPC
Example
Get access token for: 
curl -X POST https://api.dropboxapi.com/2/users/get_space_usage \
    --header "Authorization: Bearer "
Parameters

No parameters.

Returns
{
    "used": 314159265,
    "allocation": {
        ".tag": "individual",
        "allocated": 10000000000
    }
}
SpaceUsage
Information about a user's space usage and quota.
used UInt64 The user's total space usage (bytes).
allocation SpaceAllocation The user's space allocation.
SpaceAllocation (open union)
Space is allocated differently based on the type of account. The value will be one of the following datatypes. New values may be introduced as our API evolves.
individual IndividualSpaceAllocation The user's space allocation applies only to their individual account.
IndividualSpaceAllocation
allocated UInt64 The total space allocated to the user's account (bytes).
team TeamSpaceAllocation The user shares space with other members of their team.
TeamSpaceAllocation
used UInt64 The total space currently used by the user's team (bytes).
allocated UInt64 The total space allocated to the user's team (bytes).
Errors

No errors.