Dropbox for HTTP Developers

file_properties

team

team_log

deprecated

Dropbox Business API

The Dropbox Business API allows apps to manage the user lifecycle for a Dropbox Business account and perform API actions on all members of a team. It also gives apps programmatic access to Dropbox Business admin functionality.

Access types

There are four different access types of Dropbox Business API permissions. You should only request access to the minimum set of permissions that your app requires:

  • Team information – Information about the team and aggregate usage data
  • Team auditing – Team information, plus the team's detailed activity log
  • Team member file access – Team information and auditing, plus the ability to perform any action as any team member
  • Team member management – Team information, plus the ability to add, edit, and delete team members

Creating an application

To create a Dropbox Business app, visit the app creation page.

Linking to a team

Developers will need to direct a Dropbox Business team administrator through the standard OAuth 2.0 flow to install their application on a Dropbox Business team. The OAuth response/redirect will include an additional team_id field that can be used to uniquely identify a team.

Dropbox Business API OAuth tokens can enable extensive access to team data, so it is your responsibility to properly secure them server-side. They should never be cached in insecure environments or downloaded to client devices.

Member file access

A Dropbox Business app can make calls to the Dropbox API for any member of the Dropbox Business team. Your app must have Team member file access permission.

To make calls on a member's behalf, use the OAuth token granted to the app by the team. Specify the member_id of the user that the app wants to act on using a custom HTTP header called Dropbox-API-Select-User.

Notes:

  • This feature is currently limited to only team members in the "active" state.
  • A common use case for Team member file access is scanning through member Dropbox accounts. The recommended approach for this is repeated calls to /files/list_folder/continue.

An additional error may occur when using Dropbox-API-Select-User:

  • 401 Member ID doesn't exist on the team.

An alternative and advanced method for Business API apps to access and perform operations on team-owned content is to use the Dropbox-API-Select-Admin HTTP header instead of Dropbox-API-Select-User.

There are a several key differences between the two:

First, both headers specify the member_id of a team member in their values, but for Dropbox-API-Select-Admin this must refer to a team admin rather than an arbitrary member.

Second, Dropbox-API-Select-User allows access to and operations on content that currently exists in the "selected" team member's Dropbox. This includes their private files and folders as well as contents of any shared or team folders they not only have access to but also have added to their Dropbox (i.e. "mounted" in API terms).

In contrast, Dropbox-API-Select-Admin allows access to and operations on any team-owned content, including unmounted content. This includes any team member's private files and folders as well as contents of any shared folders owned by a member of the team and team folders. In particular, the team admin being impersonated doesn't have to have the target content in their Dropbox and doesn't have to be in the membership of any shared or team folders the content might reside in.

Specifically, there are two different modes for Dropbox-API-Select-Admin header:

  • Whole Team The endpoint can access content of team folders as well as team member's private files.
  • Team Admin The endpoint can access content of team folders but not team member's private files.

The supported Dropbox-API-Select-Admin mode for each API endpoint is documented under Authentication section.

In general, Whole Team is supported by read-only endpoints in order to simplify referring to and traversing team-owned content. Conversely, Team Admin is supported by mutable calls in order to perform particular actions an administrator (rather than user) - which may be a required permission for some operations within team spaces.

Since traditional logical paths in Dropbox must refer to mounted content, the endpoints that support the Dropbox-API-Select-Admin header accept namespace-relative paths. These take the format of ns:<namespace_id><namespace_path>, where <namespace_id> is the shared_folder_id or team_folder_id of the shared folder or the team folder containing the file or folder, respectively, and <namespace_path> is the logical path to the content relative to its shared folder or team folder container. See our namespace guide for more information.

Note that not all User API endpoints support the Dropbox-API-Select-Admin header. Check the API docs for a list of endpoints that do.

Production status

When first created, an app will be in "Development" mode, which means it will only be able to link to a single team. You can enable up to 5 additional development teams from your app's info page on the App Console by clicking Enable additional teams. When you are ready to exit development and deploy your app more broadly, you will need to apply for Production status.

Webhooks

Dropbox Business API apps that have specified a webhook URL in the App Console will receive change notifications for the team. There are two classes of change notifications, each associated with different permissions.

Team member file access notifications

Apps with the Team member file access permission will receive per-user webhook notifications from all members of the team. The webhook notification contains a list of all member_ids that have changes within their account. This is similar to the Dropbox API webhooks behavior.

For Team member file access notifications, your endpoint will receive JSON with the following format:

{
  "list_folder": {
    "teams": {
      "team_id1": [
        "member_id1",
        "member_id2",
        ...
      ],
      "team_id2": [
        "member_id1",
        "member_id2",
        ...
      ],
      ...
    }
  },
  "delta": {
    "teams": {
      "team_id1": [
        "member_id1",
        "member_id2",
        ...
      ],
      "team_id2": [
        "member_id1",
        "member_id2",
        ...
      ],
      ...
    }
  }
}

Note that a single change to a file in a shared folder will trigger a webhook for each user that the folder is shared with (and will also show up in the /list_folder entries for each account). You may want to track these occurrences to avoid re-processing the same file multiple times. One possible method would be to track a combination of the (unique) shared folder ID, file path, and rev for a file to identify if it is the same as a previously-processed change. Files outside a shared folder don't have this concern.

Team change notifications

Apps with Team member management or Team member file access permissions will receive webhook notifications for changes to the team membership. This type of notification will be triggered in the following cases:

  • User is invited to team
  • User joins team (transitions from "invited" to "active" status)
  • User is removed from team
  • User's profile or permissions are updated

For Team change notifications, your endpoint will receive JSON with the following format:

{
  "team_events": [
    {
      "event": "member_info_change",
      "team_id": "team_id1",
      "member_ids": [
        "member_id1",
        "member_id2",
        ...
      ]
    },
    ...
  ]
}

auth

contacts

file_properties

This namespace contains helpers for property and template metadata endpoints.

These endpoints enable you to tag arbitrary key/value data to Dropbox files.

The most basic unit in this namespace is the PropertyField. These fields encapsulate the actual key/value data.

Fields are added to a Dropbox file using a PropertyGroup. Property groups contain a reference to a Dropbox file and a PropertyGroupTemplate. Property groups are uniquely identified by the combination of their associated Dropbox file and template.

The PropertyGroupTemplate is a way of restricting the possible key names and value types of the data within a property group. The possible key names and value types are explicitly enumerated using PropertyFieldTemplate objects.

You can think of a property group template as a class definition for a particular key/value metadata object, and the property groups themselves as the instantiations of these objects.

Templates are owned either by a user/app pair or team/app pair. Templates and their associated properties can't be accessed by any app other than the app that created them, and even then, only when the app is linked with the owner of the template (either a user or team).

User-owned templates are accessed via the user-auth file_properties/templates/*_for_user endpoints, while team-owned templates are accessed via the team-auth file_properties/templates/*_for_team endpoints. Properties associated with either type of template can be accessed via the user-auth properties/* endpoints.

Finally, properties can be accessed from a number of endpoints that return metadata, including `files/get_metadata`, and `files/list_folder`. Properties can also be added during upload, using `files/upload`.

/templates/add_for_team

Version
Description

Add a template associated with a team. See properties/add to add properties to a file or folder.
Note: this endpoint will create team-owned templates.

URL Structure
https://api.dropboxapi.com/2/file_properties/templates/add_for_team
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/file_properties/templates/add_for_team \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"name\": \"Security\",\"description\": \"These properties describe how confidential this file or folder is.\",\"fields\": [{\"name\": \"Security Policy\",\"description\": \"This is the security policy of the file or folder described.\nPolicies can be Confidential, Public or Internal.\",\"type\": \"string\"}]}"
Parameters
{
    "name": "Security",
    "description": "These properties describe how confidential this file or folder is.",
    "fields": [
        {
            "name": "Security Policy",
            "description": "This is the security policy of the file or folder described.\nPolicies can be Confidential, Public or Internal.",
            "type": "string"
        }
    ]
}
AddTemplateArg
name String Display name for the template. Template names can be up to 256 bytes.
description String Description for the template. Template descriptions can be up to 1024 bytes.
fields List of (PropertyFieldTemplate) Definitions of the property fields associated with this template. There can be up to 32 properties in a single template.
PropertyFieldTemplate
Defines how a single property field may be structured. Used exclusively by PropertyGroupTemplate.
name String Key of the property field being described. Property field keys can be up to 256 bytes.
description String Description of the property field. Property field descriptions can be up to 1024 bytes.
type PropertyType Data type of the value of this property field. This type will be enforced upon property creation and modifications.
PropertyType (open union)
Data type of the given property field added. The value will be one of the following datatypes. New values may be introduced as our API evolves.
string Void The associated property field will be of type string. Unicode is supported.
Returns
{
    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa"
}
AddTemplateResult
template_id String(min_length=1, pattern="(/|ptid:).*") An identifier for template added by See templates/add_for_user or templates/add_for_team.
Errors
Example: restricted_content
{
    "error_summary": "restricted_content/...",
    "error": {
        ".tag": "restricted_content"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: conflicting_property_names
{
    "error_summary": "conflicting_property_names/...",
    "error": {
        ".tag": "conflicting_property_names"
    }
}
Example: too_many_properties
{
    "error_summary": "too_many_properties/...",
    "error": {
        ".tag": "too_many_properties"
    }
}
Example: too_many_templates
{
    "error_summary": "too_many_templates/...",
    "error": {
        ".tag": "too_many_templates"
    }
}
Example: template_attribute_too_large
{
    "error_summary": "template_attribute_too_large/...",
    "error": {
        ".tag": "template_attribute_too_large"
    }
}
ModifyTemplateError (union)
The value will be one of the following datatypes:
template_not_found String(min_length=1, pattern="(/|ptid:).*") Template does not exist for the given identifier.
restricted_content Void You do not have permission to modify this template.
conflicting_property_names Void A property field key with that name already exists in the template.
too_many_properties Void There are too many properties in the changed template. The maximum number of properties per template is 32.
too_many_templates Void There are too many templates for the team.
template_attribute_too_large Void The template name, description or one or more of the property field keys is too large.

/templates/get_for_team

Version
Description

Get the schema for a specified template.

URL Structure
https://api.dropboxapi.com/2/file_properties/templates/get_for_team
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/file_properties/templates/get_for_team \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"template_id\": \"ptid:1a5n2i6d3OYEAAAAAAAAAYa\"}"
Parameters
{
    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa"
}
GetTemplateArg
template_id String(min_length=1, pattern="(/|ptid:).*") An identifier for template added by route See templates/add_for_user or templates/add_for_team.
Returns
{
    "name": "Security",
    "description": "These properties describe how confidential this file or folder is.",
    "fields": [
        {
            "name": "Security Policy",
            "description": "This is the security policy of the file or folder described.\nPolicies can be Confidential, Public or Internal.",
            "type": {
                ".tag": "string"
            }
        }
    ]
}
GetTemplateResult
name String Display name for the template. Template names can be up to 256 bytes.
description String Description for the template. Template descriptions can be up to 1024 bytes.
fields List of (PropertyFieldTemplate) Definitions of the property fields associated with this template. There can be up to 32 properties in a single template.
PropertyFieldTemplate
Defines how a single property field may be structured. Used exclusively by PropertyGroupTemplate.
name String Key of the property field being described. Property field keys can be up to 256 bytes.
description String Description of the property field. Property field descriptions can be up to 1024 bytes.
type PropertyType Data type of the value of this property field. This type will be enforced upon property creation and modifications.
PropertyType (open union)
Data type of the given property field added. The value will be one of the following datatypes. New values may be introduced as our API evolves.
string Void The associated property field will be of type string. Unicode is supported.
Errors
Example: restricted_content
{
    "error_summary": "restricted_content/...",
    "error": {
        ".tag": "restricted_content"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TemplateError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
template_not_found String(min_length=1, pattern="(/|ptid:).*") Template does not exist for the given identifier.
restricted_content Void You do not have permission to modify this template.

/templates/list_for_team

Version
Description

Get the template identifiers for a team. To get the schema of each template use templates/get_for_team.

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

No parameters.

Returns
{
    "template_ids": [
        "ptid:1a5n2i6d3OYEAAAAAAAAAYa"
    ]
}
ListTemplateResult
template_ids List of (String(min_length=1, pattern="(/|ptid:).*")) List of identifiers for templates added by See templates/add_for_user or templates/add_for_team.
Errors
Example: restricted_content
{
    "error_summary": "restricted_content/...",
    "error": {
        ".tag": "restricted_content"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TemplateError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
template_not_found String(min_length=1, pattern="(/|ptid:).*") Template does not exist for the given identifier.
restricted_content Void You do not have permission to modify this template.

/templates/remove_for_team

Version
Description

Permanently removes the specified template created from templates/add_for_user. All properties associated with the template will also be removed. This action cannot be undone.

URL Structure
https://api.dropboxapi.com/2/file_properties/templates/remove_for_team
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/file_properties/templates/remove_for_team \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"template_id\": \"ptid:1a5n2i6d3OYEAAAAAAAAAYa\"}"
Parameters
{
    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa"
}
RemoveTemplateArg
template_id String(min_length=1, pattern="(/|ptid:).*") An identifier for a template created by templates/add_for_user or templates/add_for_team.
Returns

No return values.

Errors
Example: restricted_content
{
    "error_summary": "restricted_content/...",
    "error": {
        ".tag": "restricted_content"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TemplateError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
template_not_found String(min_length=1, pattern="(/|ptid:).*") Template does not exist for the given identifier.
restricted_content Void You do not have permission to modify this template.

/templates/update_for_team

Version
Description

Update a template associated with a team. This route can update the template name, the template description and add optional properties to templates.

URL Structure
https://api.dropboxapi.com/2/file_properties/templates/update_for_team
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/file_properties/templates/update_for_team \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"template_id\": \"ptid:1a5n2i6d3OYEAAAAAAAAAYa\",\"name\": \"New Security Template Name\",\"description\": \"These properties will describe how confidential this file or folder is.\",\"add_fields\": [{\"name\": \"Security Policy\",\"description\": \"This is the security policy of the file or folder described.\nPolicies can be Confidential, Public or Internal.\",\"type\": \"string\"}]}"
Parameters
{
    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
    "name": "New Security Template Name",
    "description": "These properties will describe how confidential this file or folder is.",
    "add_fields": [
        {
            "name": "Security Policy",
            "description": "This is the security policy of the file or folder described.\nPolicies can be Confidential, Public or Internal.",
            "type": "string"
        }
    ]
}
UpdateTemplateArg
template_id String(min_length=1, pattern="(/|ptid:).*") An identifier for template added by See templates/add_for_user or templates/add_for_team.
name String? A display name for the template. template names can be up to 256 bytes. This field is optional.
description String? Description for the new template. Template descriptions can be up to 1024 bytes. This field is optional.
add_fields List of (PropertyFieldTemplate)? Property field templates to be added to the group template. There can be up to 32 properties in a single template. This field is optional.
PropertyFieldTemplate
Defines how a single property field may be structured. Used exclusively by PropertyGroupTemplate.
name String Key of the property field being described. Property field keys can be up to 256 bytes.
description String Description of the property field. Property field descriptions can be up to 1024 bytes.
type PropertyType Data type of the value of this property field. This type will be enforced upon property creation and modifications.
PropertyType (open union)
Data type of the given property field added. The value will be one of the following datatypes. New values may be introduced as our API evolves.
string Void The associated property field will be of type string. Unicode is supported.
Returns
{
    "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa"
}
UpdateTemplateResult
template_id String(min_length=1, pattern="(/|ptid:).*") An identifier for template added by route See templates/add_for_user or templates/add_for_team.
Errors
Example: restricted_content
{
    "error_summary": "restricted_content/...",
    "error": {
        ".tag": "restricted_content"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: conflicting_property_names
{
    "error_summary": "conflicting_property_names/...",
    "error": {
        ".tag": "conflicting_property_names"
    }
}
Example: too_many_properties
{
    "error_summary": "too_many_properties/...",
    "error": {
        ".tag": "too_many_properties"
    }
}
Example: too_many_templates
{
    "error_summary": "too_many_templates/...",
    "error": {
        ".tag": "too_many_templates"
    }
}
Example: template_attribute_too_large
{
    "error_summary": "template_attribute_too_large/...",
    "error": {
        ".tag": "template_attribute_too_large"
    }
}
ModifyTemplateError (union)
The value will be one of the following datatypes:
template_not_found String(min_length=1, pattern="(/|ptid:).*") Template does not exist for the given identifier.
restricted_content Void You do not have permission to modify this template.
conflicting_property_names Void A property field key with that name already exists in the template.
too_many_properties Void There are too many properties in the changed template. The maximum number of properties per template is 32.
too_many_templates Void There are too many templates for the team.
template_attribute_too_large Void The template name, description or one or more of the property field keys is too large.

file_requests

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

files

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

paper

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

sharing

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

team

/devices/list_member_devices

Version
Description

List all device sessions of a team's member.

URL Structure
https://api.dropboxapi.com/2/team/devices/list_member_devices
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/devices/list_member_devices \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"team_member_id\": \"dbmid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I\",\"include_web_sessions\": true,\"include_desktop_clients\": true,\"include_mobile_clients\": true}"
Parameters
{
    "team_member_id": "dbmid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I",
    "include_web_sessions": true,
    "include_desktop_clients": true,
    "include_mobile_clients": true
}
ListMemberDevicesArg
team_member_id String The team's member id.
include_web_sessions Boolean Whether to list web sessions of the team's member. The default for this field is True.
include_desktop_clients Boolean Whether to list linked desktop devices of the team's member. The default for this field is True.
include_mobile_clients Boolean Whether to list linked mobile devices of the team's member. The default for this field is True.
Returns
ListMemberDevicesResult
active_web_sessions List of (ActiveWebSession)? List of web sessions made by this team member. This field is optional.
ActiveWebSession
Information on active web sessions.
session_id String The session id.
user_agent String Information on the hosting device.
os String Information on the hosting operating system.
browser String Information on the browser used for this web session.
ip_address String? The IP address of the last activity from this session. This field is optional.
country String? The country from which the last activity from this session was made. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. This field is optional.
expires Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session expires. This field is optional.
desktop_client_sessions List of (DesktopClientSession)? List of desktop clients used by this team member. This field is optional.
DesktopClientSession
Information about linked Dropbox desktop client sessions.
session_id String The session id.
host_name String Name of the hosting desktop.
client_type DesktopPlatform The Dropbox desktop client type.
DesktopPlatform (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
windows Void Official Windows Dropbox desktop client.
mac Void Official Mac Dropbox desktop client.
linux Void Official Linux Dropbox desktop client.
client_version String The Dropbox client version.
platform String Information on the hosting platform.
is_delete_on_unlink_supported Boolean Whether it's possible to delete all of the account files upon unlinking.
ip_address String? The IP address of the last activity from this session. This field is optional.
country String? The country from which the last activity from this session was made. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. This field is optional.
mobile_client_sessions List of (MobileClientSession)? List of mobile client used by this team member. This field is optional.
MobileClientSession
Information about linked Dropbox mobile client sessions.
session_id String The session id.
device_name String The device name.
client_type MobileClientPlatform The mobile application type.
MobileClientPlatform (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
iphone Void Official Dropbox iPhone client.
ipad Void Official Dropbox iPad client.
android Void Official Dropbox Android client.
windows_phone Void Official Dropbox Windows phone client.
blackberry Void Official Dropbox Blackberry client.
ip_address String? The IP address of the last activity from this session. This field is optional.
country String? The country from which the last activity from this session was made. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. This field is optional.
client_version String? The dropbox client version. This field is optional.
os_version String? The hosting OS version. This field is optional.
last_carrier String? last carrier used by the device. This field is optional.
Errors
Example: member_not_found
{
    "error_summary": "member_not_found/...",
    "error": {
        ".tag": "member_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListMemberDevicesError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
member_not_found Void Member not found.

/devices/list_members_devices

Version
Description

List all device sessions of a team.

URL Structure
https://api.dropboxapi.com/2/team/devices/list_members_devices
Authentication
Team Authentication
Endpoint format
RPC
Parameters
ListMembersDevicesArg
cursor String? At the first call to the devices/list_members_devices the cursor shouldn't be passed. Then, if the result of the call includes a cursor, the following requests should include the received cursors in order to receive the next sub list of team devices. This field is optional.
include_web_sessions Boolean Whether to list web sessions of the team members. The default for this field is True.
include_desktop_clients Boolean Whether to list desktop clients of the team members. The default for this field is True.
include_mobile_clients Boolean Whether to list mobile clients of the team members. The default for this field is True.
Returns
ListMembersDevicesResult
devices List of (MemberDevices) The devices of each member of the team.
MemberDevices
Information on devices of a team's member.
team_member_id String The member unique Id.
web_sessions List of (ActiveWebSession)? List of web sessions made by this team member. This field is optional.
ActiveWebSession
Information on active web sessions.
session_id String The session id.
user_agent String Information on the hosting device.
os String Information on the hosting operating system.
browser String Information on the browser used for this web session.
ip_address String? The IP address of the last activity from this session. This field is optional.
country String? The country from which the last activity from this session was made. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. This field is optional.
expires Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session expires. This field is optional.
desktop_clients List of (DesktopClientSession)? List of desktop clients by this team member. This field is optional.
DesktopClientSession
Information about linked Dropbox desktop client sessions.
session_id String The session id.
host_name String Name of the hosting desktop.
client_type DesktopPlatform The Dropbox desktop client type.
DesktopPlatform (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
windows Void Official Windows Dropbox desktop client.
mac Void Official Mac Dropbox desktop client.
linux Void Official Linux Dropbox desktop client.
client_version String The Dropbox client version.
platform String Information on the hosting platform.
is_delete_on_unlink_supported Boolean Whether it's possible to delete all of the account files upon unlinking.
ip_address String? The IP address of the last activity from this session. This field is optional.
country String? The country from which the last activity from this session was made. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. This field is optional.
mobile_clients List of (MobileClientSession)? List of mobile clients by this team member. This field is optional.
MobileClientSession
Information about linked Dropbox mobile client sessions.
session_id String The session id.
device_name String The device name.
client_type MobileClientPlatform The mobile application type.
MobileClientPlatform (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
iphone Void Official Dropbox iPhone client.
ipad Void Official Dropbox iPad client.
android Void Official Dropbox Android client.
windows_phone Void Official Dropbox Windows phone client.
blackberry Void Official Dropbox Blackberry client.
ip_address String? The IP address of the last activity from this session. This field is optional.
country String? The country from which the last activity from this session was made. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. This field is optional.
client_version String? The dropbox client version. This field is optional.
os_version String? The hosting OS version. This field is optional.
last_carrier String? last carrier used by the device. This field is optional.
has_more Boolean If true, then there are more devices available. Pass the cursor to devices/list_members_devices to retrieve the rest.
cursor String? Pass the cursor into devices/list_members_devices to receive the next sub list of team's devices. This field is optional.
Errors
Example: reset
{
    "error_summary": "reset/...",
    "error": {
        ".tag": "reset"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListMembersDevicesError (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 devices/list_members_devices again with an empty cursor to obtain a new cursor.

/devices/revoke_device_session

Version
Description

Revoke a device session of a team's member.

URL Structure
https://api.dropboxapi.com/2/team/devices/revoke_device_session
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/devices/revoke_device_session \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\".tag\": \"web_session\",\"session_id\": \"1234faaf0678bcde\",\"team_member_id\": \"dbmid:AAHhy7WsR0x-u4ZCqiDl5Fz5zvuL3kmspwU\"}"
Parameters
{
    ".tag": "web_session",
    "session_id": "1234faaf0678bcde",
    "team_member_id": "dbmid:AAHhy7WsR0x-u4ZCqiDl5Fz5zvuL3kmspwU"
}
RevokeDeviceSessionArg (union)
The value will be one of the following datatypes:
web_session DeviceSessionArg End an active session.
DeviceSessionArg
session_id String The session id.
team_member_id String The unique id of the member owning the device.
desktop_client RevokeDesktopClientArg Unlink a linked desktop device.
RevokeDesktopClientArg
session_id String The session id.
team_member_id String The unique id of the member owning the device.
delete_on_unlink Boolean Whether to delete all files of the account (this is possible only if supported by the desktop client and will be made the next time the client access the account). The default for this field is False.
mobile_client DeviceSessionArg Unlink a linked mobile device.
DeviceSessionArg
session_id String The session id.
team_member_id String The unique id of the member owning the device.
Returns

No return values.

Errors
Example: device_session_not_found
{
    "error_summary": "device_session_not_found/...",
    "error": {
        ".tag": "device_session_not_found"
    }
}
Example: member_not_found
{
    "error_summary": "member_not_found/...",
    "error": {
        ".tag": "member_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RevokeDeviceSessionError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
device_session_not_found Void Device session not found.
member_not_found Void Member not found.

/devices/revoke_device_session_batch

Version
Description

Revoke a list of device sessions of team members.

URL Structure
https://api.dropboxapi.com/2/team/devices/revoke_device_session_batch
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/devices/revoke_device_session_batch \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"revoke_devices\": [{\".tag\": \"web_session\",\"session_id\": \"1234faaf0678bcde\",\"team_member_id\": \"dbmid:AAHhy7WsR0x-u4ZCqiDl5Fz5zvuL3kmspwU\"}]}"
Parameters
{
    "revoke_devices": [
        {
            ".tag": "web_session",
            "session_id": "1234faaf0678bcde",
            "team_member_id": "dbmid:AAHhy7WsR0x-u4ZCqiDl5Fz5zvuL3kmspwU"
        }
    ]
}
RevokeDeviceSessionBatchArg
revoke_devices List of (RevokeDeviceSessionArg)
RevokeDeviceSessionArg (union)
The value will be one of the following datatypes:
web_session DeviceSessionArg End an active session.
DeviceSessionArg
session_id String The session id.
team_member_id String The unique id of the member owning the device.
desktop_client RevokeDesktopClientArg Unlink a linked desktop device.
RevokeDesktopClientArg
session_id String The session id.
team_member_id String The unique id of the member owning the device.
delete_on_unlink Boolean Whether to delete all files of the account (this is possible only if supported by the desktop client and will be made the next time the client access the account). The default for this field is False.
mobile_client DeviceSessionArg Unlink a linked mobile device.
DeviceSessionArg
session_id String The session id.
team_member_id String The unique id of the member owning the device.
Returns
RevokeDeviceSessionBatchResult
revoke_devices_status List of (RevokeDeviceSessionStatus)
RevokeDeviceSessionStatus
success Boolean Result of the revoking request.
error_type RevokeDeviceSessionError? The error cause in case of a failure. This field is optional.
RevokeDeviceSessionError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
device_session_not_found Void Device session not found.
member_not_found Void Member not found.
Errors
RevokeDeviceSessionBatchError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.

/features/get_values

Version
Description

Get the values for one or more featues. This route allows you to check your account's capability for what feature you can access or what value you have for certain features.
Permission : Team information.

URL Structure
https://api.dropboxapi.com/2/team/features/get_values
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/features/get_values \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"features\": [{\".tag\": \"upload_api_rate_limit\"},{\".tag\": \"has_team_shared_dropbox\"}]}"
Parameters
{
    "features": [
        {
            ".tag": "upload_api_rate_limit"
        },
        {
            ".tag": "has_team_shared_dropbox"
        }
    ]
}
FeaturesGetValuesBatchArg
features List of (Feature) A list of features in Feature. If the list is empty, this route will return FeaturesGetValuesBatchError.
Feature (open union)
A set of features that a Dropbox Business account may support. The value will be one of the following datatypes. New values may be introduced as our API evolves.
upload_api_rate_limit Void The number of upload API calls allowed per month.
has_team_shared_dropbox Void Does this team have a shared team root.
has_team_file_events Void Does this team have file events.
has_team_selective_sync Void Does this team have team selective sync enabled.
Returns
{
    "values": [
        {
            ".tag": "upload_api_rate_limit",
            "upload_api_rate_limit": {
                ".tag": "limit",
                "limit": 25000
            }
        },
        {
            ".tag": "has_team_shared_dropbox",
            "has_team_shared_dropbox": {
                ".tag": "has_team_shared_dropbox",
                "has_team_shared_dropbox": false
            }
        }
    ]
}
FeaturesGetValuesBatchResult
values List of (FeatureValue)
FeatureValue (open union)
The values correspond to entries in Feature. You may get different value according to your Dropbox Business plan. The value will be one of the following datatypes. New values may be introduced as our API evolves.
upload_api_rate_limit UploadApiRateLimitValue
UploadApiRateLimitValue (open union)
The value for Feature.upload_api_rate_limit. The value will be one of the following datatypes. New values may be introduced as our API evolves.
unlimited Void This team has unlimited upload API quota. So far both server version account and legacy account type have unlimited monthly upload api quota.
limit UInt32 The number of upload API calls allowed per month.
has_team_shared_dropbox HasTeamSharedDropboxValue
HasTeamSharedDropboxValue (open union)
The value for Feature.has_team_shared_dropbox. The value will be one of the following datatypes. New values may be introduced as our API evolves.
has_team_shared_dropbox Boolean Does this team have a shared team root.
has_team_file_events HasTeamFileEventsValue
HasTeamFileEventsValue (open union)
The value for Feature.has_team_file_events. The value will be one of the following datatypes. New values may be introduced as our API evolves.
enabled Boolean Does this team have file events.
has_team_selective_sync HasTeamSelectiveSyncValue
HasTeamSelectiveSyncValue (open union)
The value for Feature.has_team_selective_sync. The value will be one of the following datatypes. New values may be introduced as our API evolves.
has_team_selective_sync Boolean Does this team have team selective sync enabled.
Errors
Example: empty_features_list
{
    "error_summary": "empty_features_list/...",
    "error": {
        ".tag": "empty_features_list"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
FeaturesGetValuesBatchError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
empty_features_list Void At least one Feature must be included in the FeaturesGetValuesBatchArg.features list.

/get_info

Version
Description

Retrieves information about a team.

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

No parameters.

Returns
{
    "name": "Dropbox Inc.",
    "team_id": "dbtid:1234abcd",
    "num_licensed_users": 5,
    "num_provisioned_users": 2,
    "policies": {
        "sharing": {
            "shared_folder_member_policy": {
                ".tag": "team"
            },
            "shared_folder_join_policy": {
                ".tag": "from_anyone"
            },
            "shared_link_create_policy": {
                ".tag": "team_only"
            }
        },
        "emm_state": {
            ".tag": "disabled"
        },
        "office_addin": {
            ".tag": "disabled"
        }
    }
}
TeamGetInfoResult
name String The name of the team.
team_id String The ID of the team.
num_licensed_users UInt32 The number of licenses available to the team.
num_provisioned_users UInt32 The number of accounts that have been invited or are already active members of the team.
policies TeamMemberPolicies
TeamMemberPolicies
Policies governing team members. This datatype comes from an imported namespace originally defined in the team_policies namespace.
sharing TeamSharingPolicies 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 Who can view shared links owned by team members.
SharedLinkCreatePolicy (open union)
Policy governing the visibility of shared links. This policy can apply to newly created shared links, or all 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 all shared links. Login will be required to access all shared links.
emm_state EmmState This describes the Enterprise Mobility Management (EMM) state for this team. This information can be used to understand if an organization is integrating with a third-party EMM vendor to further manage and apply restrictions upon the team's Dropbox usage on mobile devices. This is a new feature and in the future we'll be adding more new fields and additional documentation.
EmmState (open union)
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.
disabled Void Emm token is disabled.
optional Void Emm token is optional.
required Void Emm token is required.
office_addin OfficeAddInPolicy The admin policy around the Dropbox Office Add-In for this team.
OfficeAddInPolicy (open union)
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.
disabled Void Office Add-In is disabled.
enabled Void Office Add-In is enabled.
Errors

No errors.

/groups/create

Version
Description

Creates a new, empty group, with a requested name.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/groups/create
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/create \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"group_name\": \"Europe sales\",\"group_external_id\": \"group-134\"}"
Parameters
{
    "group_name": "Europe sales",
    "group_external_id": "group-134"
}
GroupCreateArg
group_name String Group name.
group_external_id String? The creator of a team can associate an arbitrary external ID to the group. This field is optional.
group_management_type GroupManagementType? Whether the team can be managed by selected users, or only by team admins. This field is optional.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
Returns
{
    "group_name": "project launch",
    "group_id": "g:e2db7665347abcd600000000001a2b3c",
    "group_management_type": {
        ".tag": "user_managed"
    },
    "created": 1447255518000,
    "member_count": 5,
    "members": [
        {
            "profile": {
                "team_member_id": "dbmid:1234567",
                "email": "mary@lamb.com",
                "email_verified": true,
                "status": {
                    ".tag": "active"
                },
                "name": {
                    "given_name": "Franz",
                    "surname": "Ferdinand",
                    "familiar_name": "Franz",
                    "display_name": "Franz Ferdinand (Personal)",
                    "abbreviated_name": "FF"
                },
                "membership_type": {
                    ".tag": "full"
                },
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "joined_on": "2015-05-12T15:50:38Z"
            },
            "access_type": {
                ".tag": "member"
            }
        }
    ]
}
GroupFullInfo
Full description of a group.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
created UInt64 The group creation time as a UTC timestamp in milliseconds since the Unix epoch.
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.
members List of (GroupMemberInfo)? List of group members. This field is optional.
GroupMemberInfo
Profile of group member, and role in group.
profile MemberProfile Profile of group member.
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
access_type GroupAccessType The role that the user has in the group.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
Errors
Example: group_name_already_used
{
    "error_summary": "group_name_already_used/...",
    "error": {
        ".tag": "group_name_already_used"
    }
}
Example: group_name_invalid
{
    "error_summary": "group_name_invalid/...",
    "error": {
        ".tag": "group_name_invalid"
    }
}
Example: external_id_already_in_use
{
    "error_summary": "external_id_already_in_use/...",
    "error": {
        ".tag": "external_id_already_in_use"
    }
}
Example: system_managed_group_disallowed
{
    "error_summary": "system_managed_group_disallowed/...",
    "error": {
        ".tag": "system_managed_group_disallowed"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GroupCreateError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
group_name_already_used Void The requested group name is already being used by another group.
group_name_invalid Void Group name is empty or has invalid characters.
external_id_already_in_use Void The requested external ID is already being used by another group.
system_managed_group_disallowed Void System-managed group cannot be manually created.

/groups/delete

Version
Description

Deletes a group.
The group is deleted immediately. However the revoking of group-owned resources may take additional time. Use the groups/job_status/get to determine whether this process has completed.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/groups/delete
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/delete \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\".tag\": \"group_id\",\"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"}"
Parameters
{
    ".tag": "group_id",
    "group_id": "g:e2db7665347abcd600000000001a2b3c"
}
GroupSelector (union)
Argument for selecting a single group, either by group_id or by external group ID. The value will be one of the following datatypes:
group_id String Group ID.
group_external_id String External ID of the group.
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: group_not_found
{
    "error_summary": "group_not_found/...",
    "error": {
        ".tag": "group_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: system_managed_group_disallowed
{
    "error_summary": "system_managed_group_disallowed/...",
    "error": {
        ".tag": "system_managed_group_disallowed"
    }
}
Example: group_already_deleted
{
    "error_summary": "group_already_deleted/...",
    "error": {
        ".tag": "group_already_deleted"
    }
}
GroupDeleteError (union)
The value will be one of the following datatypes:
group_not_found Void No matching group found. No groups match the specified group ID.
system_managed_group_disallowed Void This operation is not supported on system-managed groups.
group_already_deleted Void This group has already been deleted.

/groups/get_info

Version
Description

Retrieves information about one or more groups. Note that the optional field GroupFullInfo.members is not returned for system-managed groups.
Permission : Team Information.

URL Structure
https://api.dropboxapi.com/2/team/groups/get_info
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/get_info \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\".tag\": \"group_ids\",\"group_ids\": [\"g:e2db7665347abcd600000000001a2b3c\",\"g:111111147abcd6000000000222222c\"]}"
Parameters
{
    ".tag": "group_ids",
    "group_ids": [
        "g:e2db7665347abcd600000000001a2b3c",
        "g:111111147abcd6000000000222222c"
    ]
}
GroupsSelector (union)
Argument for selecting a list of groups, either by group_ids, or external group IDs. The value will be one of the following datatypes:
group_ids List of (String) List of group IDs.
group_external_ids List of (String) List of external IDs of groups.
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
GroupsGetInfoItem (union)
The value will be one of the following datatypes:
id_not_found String An ID that was provided as a parameter to groups/get_info, and did not match a corresponding group. The ID can be a group ID, or an external ID, depending on how the method was called.
group_info GroupFullInfo Info about a group.
GroupFullInfo
Full description of a group.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
created UInt64 The group creation time as a UTC timestamp in milliseconds since the Unix epoch.
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.
members List of (GroupMemberInfo)? List of group members. This field is optional.
GroupMemberInfo
Profile of group member, and role in group.
profile MemberProfile Profile of group member.
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
access_type GroupAccessType The role that the user has in the group.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
Errors
Example: group_not_on_team
{
    "error_summary": "group_not_on_team/...",
    "error": {
        ".tag": "group_not_on_team"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GroupsGetInfoError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
group_not_on_team Void The group is not on your team.

/groups/job_status/get

Version
Description

Once an async_job_id is returned from groups/delete, groups/members/add , or groups/members/remove use this method to poll the status of granting/revoking group members' access to group-owned resources.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/groups/job_status/get
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/job_status/get \
    --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: complete
{
    ".tag": "complete"
}
Example: in_progress
{
    ".tag": "in_progress"
}
PollEmptyResult (union)
Result returned by methods that poll for the status of an asynchronous job. Upon 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:
in_progress Void The asynchronous job is still in progress.
complete Void The asynchronous job has completed successfully.
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"
    }
}
Example: access_denied
{
    "error_summary": "access_denied/...",
    "error": {
        ".tag": "access_denied"
    }
}
GroupsPollError (union)
The value will be one of the following datatypes:
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.
access_denied Void You are not allowed to poll this job.

/groups/list

Version
Description

Lists groups on a team.
Permission : Team Information.

URL Structure
https://api.dropboxapi.com/2/team/groups/list
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/list \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"limit\": 100}"
Parameters
{
    "limit": 100
}
GroupsListArg
limit UInt32(min=1, max=1000) Number of results to return per call. The default for this field is 1000.
Returns
{
    "groups": [
        {
            "group_name": "Test group",
            "group_id": "g:e2db7665347abcd600000000001a2b3c",
            "group_management_type": {
                ".tag": "user_managed"
            },
            "member_count": 10
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
GroupsListResult
groups List of (GroupSummary)
GroupSummary
Information about a group. This datatype comes from an imported namespace originally defined in the team_common namespace.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
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.
cursor String Pass the cursor into groups/list/continue to obtain the additional groups.
has_more Boolean Is true if there are additional groups that have not been returned yet. An additional call to groups/list/continue can retrieve them.
Errors

No errors.

/groups/list/continue

Version
Description

Once a cursor has been retrieved from groups/list, use this to paginate through all groups.
Permission : Team Information.

URL Structure
https://api.dropboxapi.com/2/team/groups/list/continue
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/list/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
GroupsListContinueArg
cursor String Indicates from what point to get the next set of groups.
Returns
{
    "groups": [
        {
            "group_name": "Test group",
            "group_id": "g:e2db7665347abcd600000000001a2b3c",
            "group_management_type": {
                ".tag": "user_managed"
            },
            "member_count": 10
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
GroupsListResult
groups List of (GroupSummary)
GroupSummary
Information about a group. This datatype comes from an imported namespace originally defined in the team_common namespace.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
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.
cursor String Pass the cursor into groups/list/continue to obtain the additional groups.
has_more Boolean Is true if there are additional groups that have not been returned yet. An additional call to groups/list/continue can retrieve them.
Errors
Example: invalid_cursor
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GroupsListContinueError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_cursor Void The cursor is invalid.

/groups/members/add

Version
Description

Adds members to a group.
The members are added immediately. However the granting of group-owned resources may take additional time. Use the groups/job_status/get to determine whether this process has completed.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/groups/members/add
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/members/add \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"group\": {\".tag\": \"group_id\",\"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"},\"members\": [{\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"access_type\": \"member\"}],\"return_members\": true}"
Parameters
{
    "group": {
        ".tag": "group_id",
        "group_id": "g:e2db7665347abcd600000000001a2b3c"
    },
    "members": [
        {
            "user": {
                ".tag": "team_member_id",
                "team_member_id": "dbmid:efgh5678"
            },
            "access_type": "member"
        }
    ],
    "return_members": true
}
GroupMembersAddArg
group GroupSelector Group to which users will be added.
GroupSelector (union)
Argument for selecting a single group, either by group_id or by external group ID. The value will be one of the following datatypes:
group_id String Group ID.
group_external_id String External ID of the group.
members List of (MemberAccess) List of users to be added to the group.
MemberAccess
Specify access type a member should have when joined to a group.
user UserSelectorArg Identity of a user.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
access_type GroupAccessType Access type.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
return_members Boolean Whether to return the list of members in the group. Note that the default value will cause all the group members to be returned in the response. This may take a long time for large groups. The default for this field is True.
Returns
{
    "group_info": {
        "group_name": "project launch",
        "group_id": "g:e2db7665347abcd600000000001a2b3c",
        "group_management_type": {
            ".tag": "user_managed"
        },
        "created": 1447255518000,
        "member_count": 5,
        "members": [
            {
                "profile": {
                    "team_member_id": "dbmid:1234567",
                    "email": "mary@lamb.com",
                    "email_verified": true,
                    "status": {
                        ".tag": "active"
                    },
                    "name": {
                        "given_name": "Franz",
                        "surname": "Ferdinand",
                        "familiar_name": "Franz",
                        "display_name": "Franz Ferdinand (Personal)",
                        "abbreviated_name": "FF"
                    },
                    "membership_type": {
                        ".tag": "full"
                    },
                    "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                    "joined_on": "2015-05-12T15:50:38Z"
                },
                "access_type": {
                    ".tag": "member"
                }
            }
        ]
    },
    "async_job_id": "99988877733388"
}
GroupMembersChangeResult
Result returned by groups/members/add and groups/members/remove.
group_info GroupFullInfo The group info after member change operation has been performed.
GroupFullInfo
Full description of a group.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
created UInt64 The group creation time as a UTC timestamp in milliseconds since the Unix epoch.
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.
members List of (GroupMemberInfo)? List of group members. This field is optional.
GroupMemberInfo
Profile of group member, and role in group.
profile MemberProfile Profile of group member.
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
access_type GroupAccessType The role that the user has in the group.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
async_job_id String(min_length=1) An ID that can be used to obtain the status of granting/revoking group-owned resources.
Errors
Example: group_not_found
{
    "error_summary": "group_not_found/...",
    "error": {
        ".tag": "group_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: system_managed_group_disallowed
{
    "error_summary": "system_managed_group_disallowed/...",
    "error": {
        ".tag": "system_managed_group_disallowed"
    }
}
Example: duplicate_user
{
    "error_summary": "duplicate_user/...",
    "error": {
        ".tag": "duplicate_user"
    }
}
Example: group_not_in_team
{
    "error_summary": "group_not_in_team/...",
    "error": {
        ".tag": "group_not_in_team"
    }
}
Example: user_must_be_active_to_be_owner
{
    "error_summary": "user_must_be_active_to_be_owner/...",
    "error": {
        ".tag": "user_must_be_active_to_be_owner"
    }
}
GroupMembersAddError (union)
The value will be one of the following datatypes:
group_not_found Void No matching group found. No groups match the specified group ID.
system_managed_group_disallowed Void This operation is not supported on system-managed groups.
duplicate_user Void You cannot add duplicate users. One or more of the members you are trying to add is already a member of the group.
group_not_in_team Void Group is not in this team. You cannot add members to a group that is outside of your team.
members_not_in_team List of (String) These members are not part of your team. Currently, you cannot add members to a group if they are not part of your team, though this may change in a subsequent version. To add new members to your Dropbox Business team, use the members/add endpoint.
users_not_found List of (String) These users were not found in Dropbox.
user_must_be_active_to_be_owner Void A suspended user cannot be added to a group as GroupAccessType.owner.
user_cannot_be_manager_of_company_managed_group List of (String) A company-managed group cannot be managed by a user.

/groups/members/list

Version
Description

Lists members of a group.
Permission : Team Information.

URL Structure
https://api.dropboxapi.com/2/team/groups/members/list
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/members/list \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"group\": {\".tag\": \"group_id\",\"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"},\"limit\": 100}"
Parameters
{
    "group": {
        ".tag": "group_id",
        "group_id": "g:e2db7665347abcd600000000001a2b3c"
    },
    "limit": 100
}
GroupsMembersListArg
group GroupSelector The group whose members are to be listed.
GroupSelector (union)
Argument for selecting a single group, either by group_id or by external group ID. The value will be one of the following datatypes:
group_id String Group ID.
group_external_id String External ID of the group.
limit UInt32(min=1, max=1000) Number of results to return per call. The default for this field is 1000.
Returns
{
    "members": [],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
GroupsMembersListResult
members List of (GroupMemberInfo)
GroupMemberInfo
Profile of group member, and role in group.
profile MemberProfile Profile of group member.
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
access_type GroupAccessType The role that the user has in the group.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
cursor String Pass the cursor into groups/members/list/continue to obtain additional group members.
has_more Boolean Is true if there are additional group members that have not been returned yet. An additional call to groups/members/list/continue can retrieve them.
Errors
Example: group_not_found
{
    "error_summary": "group_not_found/...",
    "error": {
        ".tag": "group_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GroupSelectorError (open union)
Error that can be raised when GroupSelector is used. The value will be one of the following datatypes. New values may be introduced as our API evolves.
group_not_found Void No matching group found. No groups match the specified group ID.

/groups/members/list/continue

Version
Description

Once a cursor has been retrieved from groups/members/list, use this to paginate through all members of the group.
Permission : Team information.

URL Structure
https://api.dropboxapi.com/2/team/groups/members/list/continue
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/members/list/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
GroupsMembersListContinueArg
cursor String Indicates from what point to get the next set of groups.
Returns
{
    "members": [],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
GroupsMembersListResult
members List of (GroupMemberInfo)
GroupMemberInfo
Profile of group member, and role in group.
profile MemberProfile Profile of group member.
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
access_type GroupAccessType The role that the user has in the group.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
cursor String Pass the cursor into groups/members/list/continue to obtain additional group members.
has_more Boolean Is true if there are additional group members that have not been returned yet. An additional call to groups/members/list/continue can retrieve them.
Errors
Example: invalid_cursor
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GroupsMembersListContinueError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_cursor Void The cursor is invalid.

/groups/members/remove

Version
Description

Removes members from a group.
The members are removed immediately. However the revoking of group-owned resources may take additional time. Use the groups/job_status/get to determine whether this process has completed.
This method permits removing the only owner of a group, even in cases where this is not possible via the web client.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/groups/members/remove
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/members/remove \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"group\": {\".tag\": \"group_id\",\"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"},\"users\": [{\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}],\"return_members\": true}"
Parameters
{
    "group": {
        ".tag": "group_id",
        "group_id": "g:e2db7665347abcd600000000001a2b3c"
    },
    "users": [
        {
            ".tag": "team_member_id",
            "team_member_id": "dbmid:efgh5678"
        }
    ],
    "return_members": true
}
GroupMembersRemoveArg
group GroupSelector Group from which users will be removed.
GroupSelector (union)
Argument for selecting a single group, either by group_id or by external group ID. The value will be one of the following datatypes:
group_id String Group ID.
group_external_id String External ID of the group.
users List of (UserSelectorArg) List of users to be removed from the group.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
return_members Boolean Whether to return the list of members in the group. Note that the default value will cause all the group members to be returned in the response. This may take a long time for large groups. The default for this field is True.
Returns
{
    "group_info": {
        "group_name": "project launch",
        "group_id": "g:e2db7665347abcd600000000001a2b3c",
        "group_management_type": {
            ".tag": "user_managed"
        },
        "created": 1447255518000,
        "member_count": 5,
        "members": [
            {
                "profile": {
                    "team_member_id": "dbmid:1234567",
                    "email": "mary@lamb.com",
                    "email_verified": true,
                    "status": {
                        ".tag": "active"
                    },
                    "name": {
                        "given_name": "Franz",
                        "surname": "Ferdinand",
                        "familiar_name": "Franz",
                        "display_name": "Franz Ferdinand (Personal)",
                        "abbreviated_name": "FF"
                    },
                    "membership_type": {
                        ".tag": "full"
                    },
                    "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                    "joined_on": "2015-05-12T15:50:38Z"
                },
                "access_type": {
                    ".tag": "member"
                }
            }
        ]
    },
    "async_job_id": "99988877733388"
}
GroupMembersChangeResult
Result returned by groups/members/add and groups/members/remove.
group_info GroupFullInfo The group info after member change operation has been performed.
GroupFullInfo
Full description of a group.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
created UInt64 The group creation time as a UTC timestamp in milliseconds since the Unix epoch.
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.
members List of (GroupMemberInfo)? List of group members. This field is optional.
GroupMemberInfo
Profile of group member, and role in group.
profile MemberProfile Profile of group member.
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
access_type GroupAccessType The role that the user has in the group.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
async_job_id String(min_length=1) An ID that can be used to obtain the status of granting/revoking group-owned resources.
Errors
Example: group_not_found
{
    "error_summary": "group_not_found/...",
    "error": {
        ".tag": "group_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: system_managed_group_disallowed
{
    "error_summary": "system_managed_group_disallowed/...",
    "error": {
        ".tag": "system_managed_group_disallowed"
    }
}
Example: member_not_in_group
{
    "error_summary": "member_not_in_group/...",
    "error": {
        ".tag": "member_not_in_group"
    }
}
Example: group_not_in_team
{
    "error_summary": "group_not_in_team/...",
    "error": {
        ".tag": "group_not_in_team"
    }
}
GroupMembersRemoveError (union)
The value will be one of the following datatypes:
group_not_found Void No matching group found. No groups match the specified group ID.
system_managed_group_disallowed Void This operation is not supported on system-managed groups.
member_not_in_group Void At least one of the specified users is not a member of the group.
group_not_in_team Void Group is not in this team. You cannot remove members from a group that is outside of your team.
members_not_in_team List of (String) These members are not part of your team.
users_not_found List of (String) These users were not found in Dropbox.

/groups/members/set_access_type

Version
Description

Sets a member's access type in a group.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/groups/members/set_access_type
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/members/set_access_type \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"group\": {\".tag\": \"group_id\",\"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"},\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"access_type\": \"member\",\"return_members\": true}"
Parameters
{
    "group": {
        ".tag": "group_id",
        "group_id": "g:e2db7665347abcd600000000001a2b3c"
    },
    "user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    },
    "access_type": "member",
    "return_members": true
}
GroupMembersSetAccessTypeArg
group GroupSelector Specify a group.
GroupSelector (union)
Argument for selecting a single group, either by group_id or by external group ID. The value will be one of the following datatypes:
group_id String Group ID.
group_external_id String External ID of the group.
user UserSelectorArg Identity of a user that is a member of group.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
access_type GroupAccessType New group access type the user will have.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
return_members Boolean Whether to return the list of members in the group. Note that the default value will cause all the group members to be returned in the response. This may take a long time for large groups. The default for this field is True.
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
GroupsGetInfoItem (union)
The value will be one of the following datatypes:
id_not_found String An ID that was provided as a parameter to groups/get_info, and did not match a corresponding group. The ID can be a group ID, or an external ID, depending on how the method was called.
group_info GroupFullInfo Info about a group.
GroupFullInfo
Full description of a group.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
created UInt64 The group creation time as a UTC timestamp in milliseconds since the Unix epoch.
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.
members List of (GroupMemberInfo)? List of group members. This field is optional.
GroupMemberInfo
Profile of group member, and role in group.
profile MemberProfile Profile of group member.
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
access_type GroupAccessType The role that the user has in the group.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
Errors
Example: group_not_found
{
    "error_summary": "group_not_found/...",
    "error": {
        ".tag": "group_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: system_managed_group_disallowed
{
    "error_summary": "system_managed_group_disallowed/...",
    "error": {
        ".tag": "system_managed_group_disallowed"
    }
}
Example: member_not_in_group
{
    "error_summary": "member_not_in_group/...",
    "error": {
        ".tag": "member_not_in_group"
    }
}
Example: user_cannot_be_manager_of_company_managed_group
{
    "error_summary": "user_cannot_be_manager_of_company_managed_group/...",
    "error": {
        ".tag": "user_cannot_be_manager_of_company_managed_group"
    }
}
GroupMemberSetAccessTypeError (union)
The value will be one of the following datatypes:
group_not_found Void No matching group found. No groups match the specified group ID.
system_managed_group_disallowed Void This operation is not supported on system-managed groups.
member_not_in_group Void The specified user is not a member of this group.
user_cannot_be_manager_of_company_managed_group Void A company managed group cannot be managed by a user.

/groups/update

Version
Description

Updates a group's name and/or external ID.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/groups/update
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/groups/update \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"group\": {\".tag\": \"group_id\",\"group_id\": \"g:e2db7665347abcd600000000001a2b3c\"},\"return_members\": true,\"new_group_name\": \"Europe west sales\",\"new_group_external_id\": \"sales-234\",\"new_group_management_type\": \"company_managed\"}"
Parameters
{
    "group": {
        ".tag": "group_id",
        "group_id": "g:e2db7665347abcd600000000001a2b3c"
    },
    "return_members": true,
    "new_group_name": "Europe west sales",
    "new_group_external_id": "sales-234",
    "new_group_management_type": "company_managed"
}
GroupUpdateArgs
group GroupSelector Specify a group.
GroupSelector (union)
Argument for selecting a single group, either by group_id or by external group ID. The value will be one of the following datatypes:
group_id String Group ID.
group_external_id String External ID of the group.
return_members Boolean Whether to return the list of members in the group. Note that the default value will cause all the group members to be returned in the response. This may take a long time for large groups. The default for this field is True.
new_group_name String? Optional argument. Set group name to this if provided. This field is optional.
new_group_external_id String? Optional argument. New group external ID. If the argument is None, the group's external_id won't be updated. If the argument is empty string, the group's external id will be cleared. This field is optional.
new_group_management_type GroupManagementType? Set new group management type, if provided. This field is optional.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
Returns
{
    "group_name": "project launch",
    "group_id": "g:e2db7665347abcd600000000001a2b3c",
    "group_management_type": {
        ".tag": "user_managed"
    },
    "created": 1447255518000,
    "member_count": 5,
    "members": [
        {
            "profile": {
                "team_member_id": "dbmid:1234567",
                "email": "mary@lamb.com",
                "email_verified": true,
                "status": {
                    ".tag": "active"
                },
                "name": {
                    "given_name": "Franz",
                    "surname": "Ferdinand",
                    "familiar_name": "Franz",
                    "display_name": "Franz Ferdinand (Personal)",
                    "abbreviated_name": "FF"
                },
                "membership_type": {
                    ".tag": "full"
                },
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "joined_on": "2015-05-12T15:50:38Z"
            },
            "access_type": {
                ".tag": "member"
            }
        }
    ]
}
GroupFullInfo
Full description of a group.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
created UInt64 The group creation time as a UTC timestamp in milliseconds since the Unix epoch.
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.
members List of (GroupMemberInfo)? List of group members. This field is optional.
GroupMemberInfo
Profile of group member, and role in group.
profile MemberProfile Profile of group member.
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
access_type GroupAccessType The role that the user has in the group.
GroupAccessType (union)
Role of a user in group. The value will be one of the following datatypes:
member Void User is a member of the group, but has no special permissions.
owner Void User can rename the group, and add/remove members.
Errors
Example: group_not_found
{
    "error_summary": "group_not_found/...",
    "error": {
        ".tag": "group_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: system_managed_group_disallowed
{
    "error_summary": "system_managed_group_disallowed/...",
    "error": {
        ".tag": "system_managed_group_disallowed"
    }
}
Example: group_name_already_used
{
    "error_summary": "group_name_already_used/...",
    "error": {
        ".tag": "group_name_already_used"
    }
}
Example: group_name_invalid
{
    "error_summary": "group_name_invalid/...",
    "error": {
        ".tag": "group_name_invalid"
    }
}
Example: external_id_already_in_use
{
    "error_summary": "external_id_already_in_use/...",
    "error": {
        ".tag": "external_id_already_in_use"
    }
}
GroupUpdateError (union)
The value will be one of the following datatypes:
group_not_found Void No matching group found. No groups match the specified group ID.
system_managed_group_disallowed Void This operation is not supported on system-managed groups.
group_name_already_used Void The requested group name is already being used by another group.
group_name_invalid Void Group name is empty or has invalid characters.
external_id_already_in_use Void The requested external ID is already being used by another group.

/linked_apps/list_member_linked_apps

Version
Description

List all linked applications of the team member.
Note, this endpoint does not list any team-linked applications.

URL Structure
https://api.dropboxapi.com/2/team/linked_apps/list_member_linked_apps
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/linked_apps/list_member_linked_apps \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"team_member_id\": \"dbmid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I\"}"
Parameters
{
    "team_member_id": "dbmid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I"
}
ListMemberAppsArg
team_member_id String The team member id.
Returns
ListMemberAppsResult
linked_api_apps List of (ApiApp) List of third party applications linked by this team member.
ApiApp
Information on linked third party applications.
app_id String The application unique id.
app_name String The application name.
is_app_folder Boolean Whether the linked application uses a dedicated folder.
publisher String? The application publisher name. This field is optional.
publisher_url String? The publisher's URL. This field is optional.
linked Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this application was linked. This field is optional.
Errors
Example: member_not_found
{
    "error_summary": "member_not_found/...",
    "error": {
        ".tag": "member_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListMemberAppsError (open union)
Error returned by linked_apps/list_member_linked_apps. The value will be one of the following datatypes. New values may be introduced as our API evolves.
member_not_found Void Member not found.

/linked_apps/list_members_linked_apps

Version
Description

List all applications linked to the team members' accounts.
Note, this endpoint does not list any team-linked applications.

URL Structure
https://api.dropboxapi.com/2/team/linked_apps/list_members_linked_apps
Authentication
Team Authentication
Endpoint format
RPC
Parameters
ListMembersAppsArg
Arguments for linked_apps/list_members_linked_apps.
cursor String? At the first call to the linked_apps/list_members_linked_apps the cursor shouldn't be passed. Then, if the result of the call includes a cursor, the following requests should include the received cursors in order to receive the next sub list of the team applications. This field is optional.
Returns
ListMembersAppsResult
Information returned by linked_apps/list_members_linked_apps.
apps List of (MemberLinkedApps) The linked applications of each member of the team.
MemberLinkedApps
Information on linked applications of a team member.
team_member_id String The member unique Id.
linked_api_apps List of (ApiApp) List of third party applications linked by this team member.
ApiApp
Information on linked third party applications.
app_id String The application unique id.
app_name String The application name.
is_app_folder Boolean Whether the linked application uses a dedicated folder.
publisher String? The application publisher name. This field is optional.
publisher_url String? The publisher's URL. This field is optional.
linked Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this application was linked. This field is optional.
has_more Boolean If true, then there are more apps available. Pass the cursor to linked_apps/list_members_linked_apps to retrieve the rest.
cursor String? Pass the cursor into linked_apps/list_members_linked_apps to receive the next sub list of team's applications. This field is optional.
Errors
Example: reset
{
    "error_summary": "reset/...",
    "error": {
        ".tag": "reset"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ListMembersAppsError (open union)
Error returned by linked_apps/list_members_linked_apps. 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 linked_apps/list_members_linked_apps again with an empty cursor to obtain a new cursor.

/linked_apps/revoke_linked_app

Version
Description

Revoke a linked application of the team member.

URL Structure
https://api.dropboxapi.com/2/team/linked_apps/revoke_linked_app
Authentication
Team Authentication
Endpoint format
RPC
Parameters
RevokeLinkedApiAppArg
app_id String The application's unique id.
team_member_id String The unique id of the member owning the device.
keep_app_folder Boolean Whether to keep the application dedicated folder (in case the application uses one). The default for this field is True.
Returns

No return values.

Errors
Example: app_not_found
{
    "error_summary": "app_not_found/...",
    "error": {
        ".tag": "app_not_found"
    }
}
Example: member_not_found
{
    "error_summary": "member_not_found/...",
    "error": {
        ".tag": "member_not_found"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RevokeLinkedAppError (open union)
Error returned by linked_apps/revoke_linked_app. The value will be one of the following datatypes. New values may be introduced as our API evolves.
app_not_found Void Application not found.
member_not_found Void Member not found.

/linked_apps/revoke_linked_app_batch

Version
Description

Revoke a list of linked applications of the team members.

URL Structure
https://api.dropboxapi.com/2/team/linked_apps/revoke_linked_app_batch
Authentication
Team Authentication
Endpoint format
RPC
Parameters
RevokeLinkedApiAppBatchArg
revoke_linked_app List of (RevokeLinkedApiAppArg)
RevokeLinkedApiAppArg
app_id String The application's unique id.
team_member_id String The unique id of the member owning the device.
keep_app_folder Boolean Whether to keep the application dedicated folder (in case the application uses one). The default for this field is True.
Returns
RevokeLinkedAppBatchResult
revoke_linked_app_status List of (RevokeLinkedAppStatus)
RevokeLinkedAppStatus
success Boolean Result of the revoking request.
error_type RevokeLinkedAppError? The error cause in case of a failure. This field is optional.
RevokeLinkedAppError (open union)
Error returned by linked_apps/revoke_linked_app. The value will be one of the following datatypes. New values may be introduced as our API evolves.
app_not_found Void Application not found.
member_not_found Void Member not found.
Errors
RevokeLinkedAppBatchError (open union)
Error returned by linked_apps/revoke_linked_app_batch. The value will be one of the following datatypes. New values may be introduced as our API evolves.

/member_space_limits/excluded_users/add

Version
PREVIEW - may change or disappear without notice
Description

Add users to member space limits excluded users list.

URL Structure
https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/add
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/add \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"users\": [{\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}]}"
Parameters
{
    "users": [
        {
            ".tag": "team_member_id",
            "team_member_id": "dbmid:efgh5678"
        }
    ]
}
ExcludedUsersUpdateArg
Argument of excluded users update operation. Should include a list of users to add/remove (according to endpoint), Maximum size of the list is 1000 users.
users List of (UserSelectorArg)? List of users to be added/removed. This field is optional.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Returns
{
    "status": {
        ".tag": "success"
    }
}
ExcludedUsersUpdateResult
Excluded users update result.
status ExcludedUsersUpdateStatus Update status.
ExcludedUsersUpdateStatus (open union)
Excluded users update operation status. The value will be one of the following datatypes. New values may be introduced as our API evolves.
success Void Update successful.
Errors
Example: users_not_in_team
{
    "error_summary": "users_not_in_team/...",
    "error": {
        ".tag": "users_not_in_team"
    }
}
Example: too_many_users
{
    "error_summary": "too_many_users/...",
    "error": {
        ".tag": "too_many_users"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ExcludedUsersUpdateError (open union)
Excluded users update error. The value will be one of the following datatypes. New values may be introduced as our API evolves.
users_not_in_team Void At least one of the users is not part of your team.
too_many_users Void A maximum of 1000 users for each of addition/removal can be supplied.

/member_space_limits/excluded_users/list

Version
PREVIEW - may change or disappear without notice
Description

List member space limits excluded users.

URL Structure
https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/list
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/list \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"limit\": 100}"
Parameters
{
    "limit": 100
}
ExcludedUsersListArg
Excluded users list argument.
limit UInt32(min=1, max=1000) Number of results to return per call. The default for this field is 1000.
Returns
{
    "users": [],
    "has_more": false,
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ExcludedUsersListResult
Excluded users list result.
users List of (MemberProfile)
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
has_more Boolean Is true if there are additional excluded users that have not been returned yet. An additional call to member_space_limits/excluded_users/list/continue can retrieve them.
cursor String? Pass the cursor into member_space_limits/excluded_users/list/continue to obtain additional excluded users. This field is optional.
Errors
Example: list_error
{
    "error_summary": "list_error/...",
    "error": {
        ".tag": "list_error"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ExcludedUsersListError (open union)
Excluded users list error. The value will be one of the following datatypes. New values may be introduced as our API evolves.
list_error Void An error occurred.

/member_space_limits/excluded_users/list/continue

Version
PREVIEW - may change or disappear without notice
Description

Continue listing member space limits excluded users.

URL Structure
https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/list/continue
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/list/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ExcludedUsersListContinueArg
Excluded users list continue argument.
cursor String Indicates from what point to get the next set of users.
Returns
{
    "users": [],
    "has_more": false,
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
ExcludedUsersListResult
Excluded users list result.
users List of (MemberProfile)
MemberProfile
Basic member profile.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
has_more Boolean Is true if there are additional excluded users that have not been returned yet. An additional call to member_space_limits/excluded_users/list/continue can retrieve them.
cursor String? Pass the cursor into member_space_limits/excluded_users/list/continue to obtain additional excluded users. This field is optional.
Errors
Example: invalid_cursor
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ExcludedUsersListContinueError (open union)
Excluded users list continue error. The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_cursor Void The cursor is invalid.

/member_space_limits/excluded_users/remove

Version
PREVIEW - may change or disappear without notice
Description

Remove users from member space limits excluded users list.

URL Structure
https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/remove
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/remove \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"users\": [{\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}]}"
Parameters
{
    "users": [
        {
            ".tag": "team_member_id",
            "team_member_id": "dbmid:efgh5678"
        }
    ]
}
ExcludedUsersUpdateArg
Argument of excluded users update operation. Should include a list of users to add/remove (according to endpoint), Maximum size of the list is 1000 users.
users List of (UserSelectorArg)? List of users to be added/removed. This field is optional.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Returns
{
    "status": {
        ".tag": "success"
    }
}
ExcludedUsersUpdateResult
Excluded users update result.
status ExcludedUsersUpdateStatus Update status.
ExcludedUsersUpdateStatus (open union)
Excluded users update operation status. The value will be one of the following datatypes. New values may be introduced as our API evolves.
success Void Update successful.
Errors
Example: users_not_in_team
{
    "error_summary": "users_not_in_team/...",
    "error": {
        ".tag": "users_not_in_team"
    }
}
Example: too_many_users
{
    "error_summary": "too_many_users/...",
    "error": {
        ".tag": "too_many_users"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
ExcludedUsersUpdateError (open union)
Excluded users update error. The value will be one of the following datatypes. New values may be introduced as our API evolves.
users_not_in_team Void At least one of the users is not part of your team.
too_many_users Void A maximum of 1000 users for each of addition/removal can be supplied.

/member_space_limits/get_custom_quota

Version
PREVIEW - may change or disappear without notice
Description

Get users custom quota. Returns none as the custom quota if none was set. A maximum of 1000 members can be specified in a single call.

URL Structure
https://api.dropboxapi.com/2/team/member_space_limits/get_custom_quota
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/member_space_limits/get_custom_quota \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"users\": [{\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}]}"
Parameters
{
    "users": [
        {
            ".tag": "team_member_id",
            "team_member_id": "dbmid:efgh5678"
        }
    ]
}
CustomQuotaUsersArg
users List of (UserSelectorArg) List of users.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
CustomQuotaResult (open union)
User custom quota. The value will be one of the following datatypes. New values may be introduced as our API evolves.
success UserCustomQuotaResult User's custom quota.
UserCustomQuotaResult
User and their custom quota in GB (1 TB = 1024 GB). No quota returns if the user has no custom quota set.
user UserSelectorArg
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
quota_gb UInt32(min=15)? This field is optional.
invalid_user UserSelectorArg Invalid user (not in team).
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Errors
Example: too_many_users
{
    "error_summary": "too_many_users/...",
    "error": {
        ".tag": "too_many_users"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
CustomQuotaError (open union)
Error returned when getting member custom quota. The value will be one of the following datatypes. New values may be introduced as our API evolves.
too_many_users Void A maximum of 1000 users can be set for a single call.

/member_space_limits/remove_custom_quota

Version
PREVIEW - may change or disappear without notice
Description

Remove users custom quota. A maximum of 1000 members can be specified in a single call.

URL Structure
https://api.dropboxapi.com/2/team/member_space_limits/remove_custom_quota
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/member_space_limits/remove_custom_quota \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"users\": [{\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}]}"
Parameters
{
    "users": [
        {
            ".tag": "team_member_id",
            "team_member_id": "dbmid:efgh5678"
        }
    ]
}
CustomQuotaUsersArg
users List of (UserSelectorArg) List of users.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
RemoveCustomQuotaResult (open union)
User result for setting member custom quota. The value will be one of the following datatypes. New values may be introduced as our API evolves.
success UserSelectorArg Successfully removed user.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
invalid_user UserSelectorArg Invalid user (not in team).
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Errors
Example: too_many_users
{
    "error_summary": "too_many_users/...",
    "error": {
        ".tag": "too_many_users"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
CustomQuotaError (open union)
Error returned when getting member custom quota. The value will be one of the following datatypes. New values may be introduced as our API evolves.
too_many_users Void A maximum of 1000 users can be set for a single call.

/member_space_limits/set_custom_quota

Version
PREVIEW - may change or disappear without notice
Description

Set users custom quota. Custom quota has to be at least 15GB. A maximum of 1000 members can be specified in a single call.

URL Structure
https://api.dropboxapi.com/2/team/member_space_limits/set_custom_quota
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/member_space_limits/set_custom_quota \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"users_and_quotas\": [{\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"quota_gb\": 30}]}"
Parameters
{
    "users_and_quotas": [
        {
            "user": {
                ".tag": "team_member_id",
                "team_member_id": "dbmid:efgh5678"
            },
            "quota_gb": 30
        }
    ]
}
SetCustomQuotaArg
users_and_quotas List of (UserCustomQuotaArg) List of users and their custom quotas.
UserCustomQuotaArg
User and their required custom quota in GB (1 TB = 1024 GB).
user UserSelectorArg
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
quota_gb UInt32(min=15)
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
CustomQuotaResult (open union)
User custom quota. The value will be one of the following datatypes. New values may be introduced as our API evolves.
success UserCustomQuotaResult User's custom quota.
UserCustomQuotaResult
User and their custom quota in GB (1 TB = 1024 GB). No quota returns if the user has no custom quota set.
user UserSelectorArg
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
quota_gb UInt32(min=15)? This field is optional.
invalid_user UserSelectorArg Invalid user (not in team).
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Errors
Example: too_many_users
{
    "error_summary": "too_many_users/...",
    "error": {
        ".tag": "too_many_users"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: some_users_are_excluded
{
    "error_summary": "some_users_are_excluded/...",
    "error": {
        ".tag": "some_users_are_excluded"
    }
}
SetCustomQuotaError (union)
Error returned when setting member custom quota. The value will be one of the following datatypes:
too_many_users Void A maximum of 1000 users can be set for a single call.
some_users_are_excluded Void Some of the users are on the excluded users list and can't have custom quota set.

/members/add

Version
Description

Adds members to a team.
Permission : Team member management
A maximum of 20 members can be specified in a single call.
If no Dropbox account exists with the email address specified, a new Dropbox account will be created with the given email address, and that account will be invited to the team.
If a personal Dropbox account exists with the email address specified in the call, this call will create a placeholder Dropbox account for the user on the team and send an email inviting the user to migrate their existing personal account onto the team.
Team member management apps are required to set an initial given_name and surname for a user to use in the team invitation and for 'Perform as team member' actions taken on the user before they become 'active'.

URL Structure
https://api.dropboxapi.com/2/team/members/add
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/add \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"new_members\": [{\"member_email\": \"tom.s@company.com\",\"member_given_name\": \"Tom\",\"member_surname\": \"Silverstone\",\"member_external_id\": \"company_id:342432\",\"send_welcome_email\": true,\"role\": \"member_only\"}],\"force_async\": false}"
Parameters
{
    "new_members": [
        {
            "member_email": "tom.s@company.com",
            "member_given_name": "Tom",
            "member_surname": "Silverstone",
            "member_external_id": "company_id:342432",
            "send_welcome_email": true,
            "role": "member_only"
        }
    ],
    "force_async": false
}
MembersAddArg
new_members List of (MemberAddArg) Details of new members to be added to the team.
MemberAddArg
member_email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
member_given_name String(max_length=100, pattern="[^/:?*<>"|]*")? Member's first name. This field is optional.
member_surname String(max_length=100, pattern="[^/:?*<>"|]*")? Member's last name. This field is optional.
member_external_id String(max_length=64)? External ID for member. This field is optional.
member_persistent_id String? Persistent ID for member. This field is only available to teams using persistent ID SAML configuration. This field is optional.
send_welcome_email Boolean Whether to send a welcome email to the member. If send_welcome_email is false, no email invitation will be sent to the user. This may be useful for apps using single sign-on (SSO) flows for onboarding that want to handle announcements themselves. The default for this field is True.
role AdminTier The default for this union is member_only.
AdminTier (union)
Describes which team-related admin permissions a user has. The value will be one of the following datatypes:
team_admin Void User is an administrator of the team - has all permissions.
user_management_admin Void User can do most user provisioning, de-provisioning and management.
support_admin Void User can do a limited set of common support tasks for existing users.
member_only Void User is not an admin of the team.
is_directory_restricted Boolean? Whether a user is directory restricted. This field is optional.
force_async Boolean Whether to force the add to happen asynchronously. The default for this field is False.
Returns
{
    ".tag": "complete",
    "complete": [
        {
            ".tag": "success",
            "profile": {
                "team_member_id": "dbmid:FDFSVF-DFSDF",
                "email": "tami@seagull.com",
                "email_verified": false,
                "status": {
                    ".tag": "active"
                },
                "name": {
                    "given_name": "Franz",
                    "surname": "Ferdinand",
                    "familiar_name": "Franz",
                    "display_name": "Franz Ferdinand (Personal)",
                    "abbreviated_name": "FF"
                },
                "membership_type": {
                    ".tag": "full"
                },
                "groups": [
                    "g:e2db7665347abcd600000000001a2b3c"
                ],
                "member_folder_id": "20",
                "external_id": "244423",
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "joined_on": "2015-05-12T15:50:38Z"
            },
            "role": {
                ".tag": "member_only"
            }
        }
    ]
}
MembersAddLaunch (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 List of (MemberAddResult)
MemberAddResult (union)
Describes the result of attempting to add a single user to the team. 'success' is the only value indicating that a user was indeed added to the team - the other values explain the type of failure that occurred, and include the email of the user for which the operation has failed. The value will be one of the following datatypes:
success TeamMemberInfo Describes a user that was successfully added to the team.
TeamMemberInfo
Information about a team member.
profile TeamMemberProfile Profile of a user as a member of a team.
TeamMemberProfile
Profile of a user as a member of a team.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
groups List of (String) List of group IDs of groups that the user belongs to.
member_folder_id String(pattern="[-_0-9a-zA-Z:]+") The namespace id of the user's root folder.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
role AdminTier The user's role in the team.
AdminTier (union)
Describes which team-related admin permissions a user has. The value will be one of the following datatypes:
team_admin Void User is an administrator of the team - has all permissions.
user_management_admin Void User can do most user provisioning, de-provisioning and management.
support_admin Void User can do a limited set of common support tasks for existing users.
member_only Void User is not an admin of the team.
team_license_limit String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") Team is already full. The organization has no available licenses.
free_team_member_limit_reached String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") Team is already full. The free team member limit has been reached.
user_already_on_team String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User is already on this team. The provided email address is associated with a user who is already a member of (including in recoverable state) or invited to the team.
user_on_another_team String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User is already on another team. The provided email address is associated with a user that is already a member or invited to another team.
user_already_paired String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User is already paired.
user_migration_failed String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User migration has failed.
duplicate_external_member_id String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") A user with the given external member ID already exists on the team (including in recoverable state).
duplicate_member_persistent_id String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") A user with the given persistent ID already exists on the team (including in recoverable state).
persistent_id_disabled String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") Persistent ID is only available to teams with persistent ID SAML configuration. Please contact Dropbox for more information.
user_creation_failed String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User creation has failed.
Errors

No errors.

/members/add/job_status/get

Version
Description

Once an async_job_id is returned from members/add , use this to poll the status of the asynchronous request.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/members/add/job_status/get
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/add/job_status/get \
    --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",
    "complete": [
        {
            ".tag": "success",
            "profile": {
                "team_member_id": "dbmid:FDFSVF-DFSDF",
                "email": "tami@seagull.com",
                "email_verified": false,
                "status": {
                    ".tag": "active"
                },
                "name": {
                    "given_name": "Franz",
                    "surname": "Ferdinand",
                    "familiar_name": "Franz",
                    "display_name": "Franz Ferdinand (Personal)",
                    "abbreviated_name": "FF"
                },
                "membership_type": {
                    ".tag": "full"
                },
                "groups": [
                    "g:e2db7665347abcd600000000001a2b3c"
                ],
                "member_folder_id": "20",
                "external_id": "244423",
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "joined_on": "2015-05-12T15:50:38Z"
            },
            "role": {
                ".tag": "member_only"
            }
        }
    ]
}
Example: in_progress
{
    ".tag": "in_progress"
}
MembersAddJobStatus (union)
The value will be one of the following datatypes:
in_progress Void The asynchronous job is still in progress.
complete List of (MemberAddResult) The asynchronous job has finished. For each member that was specified in the parameter MembersAddArg that was provided to members/add, a corresponding item is returned in this list.
MemberAddResult (union)
Describes the result of attempting to add a single user to the team. 'success' is the only value indicating that a user was indeed added to the team - the other values explain the type of failure that occurred, and include the email of the user for which the operation has failed. The value will be one of the following datatypes:
success TeamMemberInfo Describes a user that was successfully added to the team.
TeamMemberInfo
Information about a team member.
profile TeamMemberProfile Profile of a user as a member of a team.
TeamMemberProfile
Profile of a user as a member of a team.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
groups List of (String) List of group IDs of groups that the user belongs to.
member_folder_id String(pattern="[-_0-9a-zA-Z:]+") The namespace id of the user's root folder.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
role AdminTier The user's role in the team.
AdminTier (union)
Describes which team-related admin permissions a user has. The value will be one of the following datatypes:
team_admin Void User is an administrator of the team - has all permissions.
user_management_admin Void User can do most user provisioning, de-provisioning and management.
support_admin Void User can do a limited set of common support tasks for existing users.
member_only Void User is not an admin of the team.
team_license_limit String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") Team is already full. The organization has no available licenses.
free_team_member_limit_reached String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") Team is already full. The free team member limit has been reached.
user_already_on_team String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User is already on this team. The provided email address is associated with a user who is already a member of (including in recoverable state) or invited to the team.
user_on_another_team String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User is already on another team. The provided email address is associated with a user that is already a member or invited to another team.
user_already_paired String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User is already paired.
user_migration_failed String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User migration has failed.
duplicate_external_member_id String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") A user with the given external member ID already exists on the team (including in recoverable state).
duplicate_member_persistent_id String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") A user with the given persistent ID already exists on the team (including in recoverable state).
persistent_id_disabled String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") Persistent ID is only available to teams with persistent ID SAML configuration. Please contact Dropbox for more information.
user_creation_failed String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$") User creation has failed.
failed String The asynchronous job returned an error. The string contains an error message.
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.

/members/get_info

Version
Description

Returns information about multiple team members.
Permission : Team information
This endpoint will return MembersGetInfoItem.id_not_found, for IDs (or emails) that cannot be matched to a valid team member.

URL Structure
https://api.dropboxapi.com/2/team/members/get_info
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/get_info \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"members\": [{\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}]}"
Parameters
{
    "members": [
        {
            ".tag": "team_member_id",
            "team_member_id": "dbmid:efgh5678"
        }
    ]
}
MembersGetInfoArgs
members List of (UserSelectorArg) List of team members.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
MembersGetInfoItem (union)
Describes a result obtained for a single user whose id was specified in the parameter of members/get_info. The value will be one of the following datatypes:
id_not_found String An ID that was provided as a parameter to members/get_info, and did not match a corresponding user. This might be a team_member_id, an email, or an external ID, depending on how the method was called.
member_info TeamMemberInfo Info about a team member.
TeamMemberInfo
Information about a team member.
profile TeamMemberProfile Profile of a user as a member of a team.
TeamMemberProfile
Profile of a user as a member of a team.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
groups List of (String) List of group IDs of groups that the user belongs to.
member_folder_id String(pattern="[-_0-9a-zA-Z:]+") The namespace id of the user's root folder.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
role AdminTier The user's role in the team.
AdminTier (union)
Describes which team-related admin permissions a user has. The value will be one of the following datatypes:
team_admin Void User is an administrator of the team - has all permissions.
user_management_admin Void User can do most user provisioning, de-provisioning and management.
support_admin Void User can do a limited set of common support tasks for existing users.
member_only Void User is not an admin of the team.
Errors
MembersGetInfoError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.

/members/list

Version
Description

Lists members of a team.
Permission : Team information.

URL Structure
https://api.dropboxapi.com/2/team/members/list
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/list \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"limit\": 100,\"include_removed\": false}"
Parameters
{
    "limit": 100,
    "include_removed": false
}
MembersListArg
limit UInt32(min=1, max=1000) Number of results to return per call. The default for this field is 1000.
include_removed Boolean Whether to return removed members. The default for this field is False.
Returns
{
    "members": [
        {
            "profile": {
                "team_member_id": "dbmid:FDFSVF-DFSDF",
                "email": "tami@seagull.com",
                "email_verified": false,
                "status": {
                    ".tag": "active"
                },
                "name": {
                    "given_name": "Franz",
                    "surname": "Ferdinand",
                    "familiar_name": "Franz",
                    "display_name": "Franz Ferdinand (Personal)",
                    "abbreviated_name": "FF"
                },
                "membership_type": {
                    ".tag": "full"
                },
                "groups": [
                    "g:e2db7665347abcd600000000001a2b3c"
                ],
                "member_folder_id": "20",
                "external_id": "244423",
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "joined_on": "2015-05-12T15:50:38Z"
            },
            "role": {
                ".tag": "member_only"
            }
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": true
}
MembersListResult
members List of (TeamMemberInfo) List of team members.
TeamMemberInfo
Information about a team member.
profile TeamMemberProfile Profile of a user as a member of a team.
TeamMemberProfile
Profile of a user as a member of a team.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
groups List of (String) List of group IDs of groups that the user belongs to.
member_folder_id String(pattern="[-_0-9a-zA-Z:]+") The namespace id of the user's root folder.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
role AdminTier The user's role in the team.
AdminTier (union)
Describes which team-related admin permissions a user has. The value will be one of the following datatypes:
team_admin Void User is an administrator of the team - has all permissions.
user_management_admin Void User can do most user provisioning, de-provisioning and management.
support_admin Void User can do a limited set of common support tasks for existing users.
member_only Void User is not an admin of the team.
cursor String Pass the cursor into members/list/continue to obtain the additional members.
has_more Boolean Is true if there are additional team members that have not been returned yet. An additional call to members/list/continue can retrieve them.
Errors
MembersListError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.

/members/list/continue

Version
Description

Once a cursor has been retrieved from members/list, use this to paginate through all team members.
Permission : Team information.

URL Structure
https://api.dropboxapi.com/2/team/members/list/continue
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/list/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
MembersListContinueArg
cursor String Indicates from what point to get the next set of members.
Returns
{
    "members": [
        {
            "profile": {
                "team_member_id": "dbmid:FDFSVF-DFSDF",
                "email": "tami@seagull.com",
                "email_verified": false,
                "status": {
                    ".tag": "active"
                },
                "name": {
                    "given_name": "Franz",
                    "surname": "Ferdinand",
                    "familiar_name": "Franz",
                    "display_name": "Franz Ferdinand (Personal)",
                    "abbreviated_name": "FF"
                },
                "membership_type": {
                    ".tag": "full"
                },
                "groups": [
                    "g:e2db7665347abcd600000000001a2b3c"
                ],
                "member_folder_id": "20",
                "external_id": "244423",
                "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
                "joined_on": "2015-05-12T15:50:38Z"
            },
            "role": {
                ".tag": "member_only"
            }
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": true
}
MembersListResult
members List of (TeamMemberInfo) List of team members.
TeamMemberInfo
Information about a team member.
profile TeamMemberProfile Profile of a user as a member of a team.
TeamMemberProfile
Profile of a user as a member of a team.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
groups List of (String) List of group IDs of groups that the user belongs to.
member_folder_id String(pattern="[-_0-9a-zA-Z:]+") The namespace id of the user's root folder.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
role AdminTier The user's role in the team.
AdminTier (union)
Describes which team-related admin permissions a user has. The value will be one of the following datatypes:
team_admin Void User is an administrator of the team - has all permissions.
user_management_admin Void User can do most user provisioning, de-provisioning and management.
support_admin Void User can do a limited set of common support tasks for existing users.
member_only Void User is not an admin of the team.
cursor String Pass the cursor into members/list/continue to obtain the additional members.
has_more Boolean Is true if there are additional team members that have not been returned yet. An additional call to members/list/continue can retrieve them.
Errors
Example: invalid_cursor
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
MembersListContinueError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_cursor Void The cursor is invalid.

/members/move_former_member_files

Version
Description

Moves removed member's files to a different member. This endpoint initiates an asynchronous job. To obtain the final result of the job, the client should periodically poll members/move_former_member_files/job_status/check.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/members/move_former_member_files
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/move_former_member_files \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"transfer_dest_id\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"transfer_admin_id\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}}"
Parameters
{
    "user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    },
    "transfer_dest_id": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    },
    "transfer_admin_id": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    }
}
MembersDataTransferArg
user UserSelectorArg Identity of user to remove/suspend/have their files moved.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
transfer_dest_id UserSelectorArg Files from the deleted member account will be transferred to this user.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
transfer_admin_id UserSelectorArg Errors during the transfer process will be sent via email to this user.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
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: user_not_found
{
    "error_summary": "user_not_found/...",
    "error": {
        ".tag": "user_not_found"
    }
}
Example: user_not_in_team
{
    "error_summary": "user_not_in_team/...",
    "error": {
        ".tag": "user_not_in_team"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: removed_and_transfer_dest_should_differ
{
    "error_summary": "removed_and_transfer_dest_should_differ/...",
    "error": {
        ".tag": "removed_and_transfer_dest_should_differ"
    }
}
Example: removed_and_transfer_admin_should_differ
{
    "error_summary": "removed_and_transfer_admin_should_differ/...",
    "error": {
        ".tag": "removed_and_transfer_admin_should_differ"
    }
}
Example: transfer_dest_user_not_found
{
    "error_summary": "transfer_dest_user_not_found/...",
    "error": {
        ".tag": "transfer_dest_user_not_found"
    }
}
Example: transfer_dest_user_not_in_team
{
    "error_summary": "transfer_dest_user_not_in_team/...",
    "error": {
        ".tag": "transfer_dest_user_not_in_team"
    }
}
Example: transfer_admin_user_not_in_team
{
    "error_summary": "transfer_admin_user_not_in_team/...",
    "error": {
        ".tag": "transfer_admin_user_not_in_team"
    }
}
Example: transfer_admin_user_not_found
{
    "error_summary": "transfer_admin_user_not_found/...",
    "error": {
        ".tag": "transfer_admin_user_not_found"
    }
}
Example: unspecified_transfer_admin_id
{
    "error_summary": "unspecified_transfer_admin_id/...",
    "error": {
        ".tag": "unspecified_transfer_admin_id"
    }
}
Example: transfer_admin_is_not_admin
{
    "error_summary": "transfer_admin_is_not_admin/...",
    "error": {
        ".tag": "transfer_admin_is_not_admin"
    }
}
Example: recipient_not_verified
{
    "error_summary": "recipient_not_verified/...",
    "error": {
        ".tag": "recipient_not_verified"
    }
}
Example: user_data_is_being_transferred
{
    "error_summary": "user_data_is_being_transferred/...",
    "error": {
        ".tag": "user_data_is_being_transferred"
    }
}
Example: user_not_removed
{
    "error_summary": "user_not_removed/...",
    "error": {
        ".tag": "user_not_removed"
    }
}
Example: user_data_cannot_be_transferred
{
    "error_summary": "user_data_cannot_be_transferred/...",
    "error": {
        ".tag": "user_data_cannot_be_transferred"
    }
}
Example: user_data_already_transferred
{
    "error_summary": "user_data_already_transferred/...",
    "error": {
        ".tag": "user_data_already_transferred"
    }
}
MembersTransferFormerMembersFilesError (union)
The value will be one of the following datatypes:
user_not_found Void No matching user found. The provided team_member_id, email, or external_id does not exist on this team.
user_not_in_team Void The user is not a member of the team.
removed_and_transfer_dest_should_differ Void Expected removed user and transfer_dest user to be different.
removed_and_transfer_admin_should_differ Void Expected removed user and transfer_admin user to be different.
transfer_dest_user_not_found Void No matching user found for the argument transfer_dest_id.
transfer_dest_user_not_in_team Void The provided transfer_dest_id does not exist on this team.
transfer_admin_user_not_in_team Void The provided transfer_admin_id does not exist on this team.
transfer_admin_user_not_found Void No matching user found for the argument transfer_admin_id.
unspecified_transfer_admin_id Void The transfer_admin_id argument must be provided when file transfer is requested.
transfer_admin_is_not_admin Void Specified transfer_admin user is not a team admin.
recipient_not_verified Void The recipient user's email is not verified.
user_data_is_being_transferred Void The user's data is being transferred. Please wait some time before retrying.
user_not_removed Void No matching removed user found for the argument user.
user_data_cannot_be_transferred Void User files aren't transferable anymore.
user_data_already_transferred Void User's data has already been transferred to another user.

/members/move_former_member_files/job_status/check

Version
Description

Once an async_job_id is returned from members/move_former_member_files , use this to poll the status of the asynchronous request.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/members/move_former_member_files/job_status/check
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/move_former_member_files/job_status/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
Example: complete
{
    ".tag": "complete"
}
Example: in_progress
{
    ".tag": "in_progress"
}
PollEmptyResult (union)
Result returned by methods that poll for the status of an asynchronous job. Upon 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:
in_progress Void The asynchronous job is still in progress.
complete Void The asynchronous job has completed successfully.
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.

/members/recover

Version
Description

Recover a deleted member.
Permission : Team member management
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.

URL Structure
https://api.dropboxapi.com/2/team/members/recover
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/recover \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}}"
Parameters
{
    "user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    }
}
MembersRecoverArg
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
user UserSelectorArg Identity of user to recover.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Returns

No return values.

Errors
Example: user_not_found
{
    "error_summary": "user_not_found/...",
    "error": {
        ".tag": "user_not_found"
    }
}
Example: user_unrecoverable
{
    "error_summary": "user_unrecoverable/...",
    "error": {
        ".tag": "user_unrecoverable"
    }
}
Example: user_not_in_team
{
    "error_summary": "user_not_in_team/...",
    "error": {
        ".tag": "user_not_in_team"
    }
}
Example: team_license_limit
{
    "error_summary": "team_license_limit/...",
    "error": {
        ".tag": "team_license_limit"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
MembersRecoverError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_found Void No matching user found. The provided team_member_id, email, or external_id does not exist on this team.
user_unrecoverable Void The user is not recoverable.
user_not_in_team Void The user is not a member of the team.
team_license_limit Void Team is full. The organization has no available licenses.

/members/remove

Version
Description

Removes a member from a team.
Permission : Team member management
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
Accounts can be recovered via members/recover for a 7 day period or until the account has been permanently deleted or transferred to another account (whichever comes first). Calling members/add while a user is still recoverable on your team will return with MemberAddResult.user_already_on_team.
Accounts can have their files transferred via the admin console for a limited time, based on the version history length associated with the team (120 days for most teams).
This endpoint may initiate an asynchronous job. To obtain the final result of the job, the client should periodically poll members/remove/job_status/get.

URL Structure
https://api.dropboxapi.com/2/team/members/remove
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/remove \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"wipe_data\": true,\"transfer_dest_id\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"transfer_admin_id\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"keep_account\": false}"
Parameters
{
    "user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    },
    "wipe_data": true,
    "transfer_dest_id": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    },
    "transfer_admin_id": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    },
    "keep_account": false
}
MembersRemoveArg
user UserSelectorArg Identity of user to remove/suspend/have their files moved.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
wipe_data Boolean If provided, controls if the user's data will be deleted on their linked devices. The default for this field is True.
transfer_dest_id UserSelectorArg? If provided, files from the deleted member account will be transferred to this user. This field is optional.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
transfer_admin_id UserSelectorArg? If provided, errors during the transfer process will be sent via email to this user. If the transfer_dest_id argument was provided, then this argument must be provided as well. This field is optional.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
keep_account Boolean Downgrade the member to a Basic account. The user will retain the email address associated with their Dropbox account and data in their account that is not restricted to team members. In order to keep the account the argument wipe_data should be set to False. 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: user_not_found
{
    "error_summary": "user_not_found/...",
    "error": {
        ".tag": "user_not_found"
    }
}
Example: user_not_in_team
{
    "error_summary": "user_not_in_team/...",
    "error": {
        ".tag": "user_not_in_team"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: removed_and_transfer_dest_should_differ
{
    "error_summary": "removed_and_transfer_dest_should_differ/...",
    "error": {
        ".tag": "removed_and_transfer_dest_should_differ"
    }
}
Example: removed_and_transfer_admin_should_differ
{
    "error_summary": "removed_and_transfer_admin_should_differ/...",
    "error": {
        ".tag": "removed_and_transfer_admin_should_differ"
    }
}
Example: transfer_dest_user_not_found
{
    "error_summary": "transfer_dest_user_not_found/...",
    "error": {
        ".tag": "transfer_dest_user_not_found"
    }
}
Example: transfer_dest_user_not_in_team
{
    "error_summary": "transfer_dest_user_not_in_team/...",
    "error": {
        ".tag": "transfer_dest_user_not_in_team"
    }
}
Example: transfer_admin_user_not_in_team
{
    "error_summary": "transfer_admin_user_not_in_team/...",
    "error": {
        ".tag": "transfer_admin_user_not_in_team"
    }
}
Example: transfer_admin_user_not_found
{
    "error_summary": "transfer_admin_user_not_found/...",
    "error": {
        ".tag": "transfer_admin_user_not_found"
    }
}
Example: unspecified_transfer_admin_id
{
    "error_summary": "unspecified_transfer_admin_id/...",
    "error": {
        ".tag": "unspecified_transfer_admin_id"
    }
}
Example: transfer_admin_is_not_admin
{
    "error_summary": "transfer_admin_is_not_admin/...",
    "error": {
        ".tag": "transfer_admin_is_not_admin"
    }
}
Example: recipient_not_verified
{
    "error_summary": "recipient_not_verified/...",
    "error": {
        ".tag": "recipient_not_verified"
    }
}
Example: remove_last_admin
{
    "error_summary": "remove_last_admin/...",
    "error": {
        ".tag": "remove_last_admin"
    }
}
Example: cannot_keep_account_and_transfer
{
    "error_summary": "cannot_keep_account_and_transfer/...",
    "error": {
        ".tag": "cannot_keep_account_and_transfer"
    }
}
Example: cannot_keep_account_and_delete_data
{
    "error_summary": "cannot_keep_account_and_delete_data/...",
    "error": {
        ".tag": "cannot_keep_account_and_delete_data"
    }
}
Example: email_address_too_long_to_be_disabled
{
    "error_summary": "email_address_too_long_to_be_disabled/...",
    "error": {
        ".tag": "email_address_too_long_to_be_disabled"
    }
}
Example: cannot_keep_invited_user_account
{
    "error_summary": "cannot_keep_invited_user_account/...",
    "error": {
        ".tag": "cannot_keep_invited_user_account"
    }
}
MembersRemoveError (union)
The value will be one of the following datatypes:
user_not_found Void No matching user found. The provided team_member_id, email, or external_id does not exist on this team.
user_not_in_team Void The user is not a member of the team.
removed_and_transfer_dest_should_differ Void Expected removed user and transfer_dest user to be different.
removed_and_transfer_admin_should_differ Void Expected removed user and transfer_admin user to be different.
transfer_dest_user_not_found Void No matching user found for the argument transfer_dest_id.
transfer_dest_user_not_in_team Void The provided transfer_dest_id does not exist on this team.
transfer_admin_user_not_in_team Void The provided transfer_admin_id does not exist on this team.
transfer_admin_user_not_found Void No matching user found for the argument transfer_admin_id.
unspecified_transfer_admin_id Void The transfer_admin_id argument must be provided when file transfer is requested.
transfer_admin_is_not_admin Void Specified transfer_admin user is not a team admin.
recipient_not_verified Void The recipient user's email is not verified.
remove_last_admin Void The user is the last admin of the team, so it cannot be removed from it.
cannot_keep_account_and_transfer Void Cannot keep account and transfer the data to another user at the same time.
cannot_keep_account_and_delete_data Void Cannot keep account and delete the data at the same time. To keep the account the argument wipe_data should be set to False.
email_address_too_long_to_be_disabled Void The email address of the user is too long to be disabled.
cannot_keep_invited_user_account Void Cannot keep account of an invited user.

/members/remove/job_status/get

Version
Description

Once an async_job_id is returned from members/remove , use this to poll the status of the asynchronous request.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/members/remove/job_status/get
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/remove/job_status/get \
    --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: complete
{
    ".tag": "complete"
}
Example: in_progress
{
    ".tag": "in_progress"
}
PollEmptyResult (union)
Result returned by methods that poll for the status of an asynchronous job. Upon 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:
in_progress Void The asynchronous job is still in progress.
complete Void The asynchronous job has completed successfully.
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.

/members/send_welcome_email

Version
Description

Sends welcome email to pending team member.
Permission : Team member management
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
No-op if team member is not pending.

URL Structure
https://api.dropboxapi.com/2/team/members/send_welcome_email
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/send_welcome_email \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}"
Parameters
{
    ".tag": "team_member_id",
    "team_member_id": "dbmid:efgh5678"
}
Example: email
{
    ".tag": "email",
    "email": "dan@hotmail.com"
}
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Returns

No return values.

Errors
Example: user_not_found
{
    "error_summary": "user_not_found/...",
    "error": {
        ".tag": "user_not_found"
    }
}
Example: user_not_in_team
{
    "error_summary": "user_not_in_team/...",
    "error": {
        ".tag": "user_not_in_team"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
MembersSendWelcomeError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_found Void No matching user found. The provided team_member_id, email, or external_id does not exist on this team.
user_not_in_team Void The user is not a member of the team.

/members/set_admin_permissions

Version
Description

Updates a team member's permissions.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/members/set_admin_permissions
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/set_admin_permissions \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"new_role\": \"member_only\"}"
Parameters
{
    "user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    },
    "new_role": "member_only"
}
MembersSetPermissionsArg
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
user UserSelectorArg Identity of user whose role will be set.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
new_role AdminTier The new role of the member.
AdminTier (union)
Describes which team-related admin permissions a user has. The value will be one of the following datatypes:
team_admin Void User is an administrator of the team - has all permissions.
user_management_admin Void User can do most user provisioning, de-provisioning and management.
support_admin Void User can do a limited set of common support tasks for existing users.
member_only Void User is not an admin of the team.
Returns
{
    "team_member_id": "dbmid:9978889",
    "role": {
        ".tag": "member_only"
    }
}
MembersSetPermissionsResult
team_member_id String The member ID of the user to which the change was applied.
role AdminTier The role after the change.
AdminTier (union)
Describes which team-related admin permissions a user has. The value will be one of the following datatypes:
team_admin Void User is an administrator of the team - has all permissions.
user_management_admin Void User can do most user provisioning, de-provisioning and management.
support_admin Void User can do a limited set of common support tasks for existing users.
member_only Void User is not an admin of the team.
Errors
Example: user_not_found
{
    "error_summary": "user_not_found/...",
    "error": {
        ".tag": "user_not_found"
    }
}
Example: last_admin
{
    "error_summary": "last_admin/...",
    "error": {
        ".tag": "last_admin"
    }
}
Example: user_not_in_team
{
    "error_summary": "user_not_in_team/...",
    "error": {
        ".tag": "user_not_in_team"
    }
}
Example: cannot_set_permissions
{
    "error_summary": "cannot_set_permissions/...",
    "error": {
        ".tag": "cannot_set_permissions"
    }
}
Example: team_license_limit
{
    "error_summary": "team_license_limit/...",
    "error": {
        ".tag": "team_license_limit"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
MembersSetPermissionsError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_found Void No matching user found. The provided team_member_id, email, or external_id does not exist on this team.
last_admin Void Cannot remove the admin setting of the last admin.
user_not_in_team Void The user is not a member of the team.
cannot_set_permissions Void Cannot remove/grant permissions.
team_license_limit Void Team is full. The organization has no available licenses.

/members/set_profile

Version
Description

Updates a team member's profile.
Permission : Team member management.

URL Structure
https://api.dropboxapi.com/2/team/members/set_profile
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/set_profile \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"new_email\": \"t.smith@domain.com\",\"new_surname\": \"Smith\"}"
Parameters
{
    "user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    },
    "new_email": "t.smith@domain.com",
    "new_surname": "Smith"
}
MembersSetProfileArg
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
At least one of new_email, new_external_id, new_given_name, and/or new_surname must be provided.
user UserSelectorArg Identity of user whose profile will be set.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
new_email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")? New email for member. This field is optional.
new_external_id String(max_length=64)? New external ID for member. This field is optional.
new_given_name String(max_length=100, pattern="[^/:?*<>"|]*")? New given name for member. This field is optional.
new_surname String(max_length=100, pattern="[^/:?*<>"|]*")? New surname for member. This field is optional.
new_persistent_id String? New persistent ID. This field only available to teams using persistent ID SAML configuration. This field is optional.
new_is_directory_restricted Boolean? New value for whether the user is a directory restricted user. This field is optional.
Returns
{
    "profile": {
        "team_member_id": "dbmid:FDFSVF-DFSDF",
        "email": "tami@seagull.com",
        "email_verified": false,
        "status": {
            ".tag": "active"
        },
        "name": {
            "given_name": "Franz",
            "surname": "Ferdinand",
            "familiar_name": "Franz",
            "display_name": "Franz Ferdinand (Personal)",
            "abbreviated_name": "FF"
        },
        "membership_type": {
            ".tag": "full"
        },
        "groups": [
            "g:e2db7665347abcd600000000001a2b3c"
        ],
        "member_folder_id": "20",
        "external_id": "244423",
        "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
        "joined_on": "2015-05-12T15:50:38Z"
    },
    "role": {
        ".tag": "member_only"
    }
}
TeamMemberInfo
Information about a team member.
profile TeamMemberProfile Profile of a user as a member of a team.
TeamMemberProfile
Profile of a user as a member of a team.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
groups List of (String) List of group IDs of groups that the user belongs to.
member_folder_id String(pattern="[-_0-9a-zA-Z:]+") The namespace id of the user's root folder.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
role AdminTier The user's role in the team.
AdminTier (union)
Describes which team-related admin permissions a user has. The value will be one of the following datatypes:
team_admin Void User is an administrator of the team - has all permissions.
user_management_admin Void User can do most user provisioning, de-provisioning and management.
support_admin Void User can do a limited set of common support tasks for existing users.
member_only Void User is not an admin of the team.
Errors
Example: user_not_found
{
    "error_summary": "user_not_found/...",
    "error": {
        ".tag": "user_not_found"
    }
}
Example: user_not_in_team
{
    "error_summary": "user_not_in_team/...",
    "error": {
        ".tag": "user_not_in_team"
    }
}
Example: external_id_and_new_external_id_unsafe
{
    "error_summary": "external_id_and_new_external_id_unsafe/...",
    "error": {
        ".tag": "external_id_and_new_external_id_unsafe"
    }
}
Example: no_new_data_specified
{
    "error_summary": "no_new_data_specified/...",
    "error": {
        ".tag": "no_new_data_specified"
    }
}
Example: email_reserved_for_other_user
{
    "error_summary": "email_reserved_for_other_user/...",
    "error": {
        ".tag": "email_reserved_for_other_user"
    }
}
Example: external_id_used_by_other_user
{
    "error_summary": "external_id_used_by_other_user/...",
    "error": {
        ".tag": "external_id_used_by_other_user"
    }
}
Example: set_profile_disallowed
{
    "error_summary": "set_profile_disallowed/...",
    "error": {
        ".tag": "set_profile_disallowed"
    }
}
Example: param_cannot_be_empty
{
    "error_summary": "param_cannot_be_empty/...",
    "error": {
        ".tag": "param_cannot_be_empty"
    }
}
Example: persistent_id_disabled
{
    "error_summary": "persistent_id_disabled/...",
    "error": {
        ".tag": "persistent_id_disabled"
    }
}
Example: persistent_id_used_by_other_user
{
    "error_summary": "persistent_id_used_by_other_user/...",
    "error": {
        ".tag": "persistent_id_used_by_other_user"
    }
}
Example: directory_restricted_off
{
    "error_summary": "directory_restricted_off/...",
    "error": {
        ".tag": "directory_restricted_off"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
MembersSetProfileError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
user_not_found Void No matching user found. The provided team_member_id, email, or external_id does not exist on this team.
user_not_in_team Void The user is not a member of the team.
external_id_and_new_external_id_unsafe Void It is unsafe to use both external_id and new_external_id.
no_new_data_specified Void None of new_email, new_given_name, new_surname, or new_external_id are specified.
email_reserved_for_other_user Void Email is already reserved for another user.
external_id_used_by_other_user Void The external ID is already in use by another team member.
set_profile_disallowed Void Modifying deleted users is not allowed.
param_cannot_be_empty Void Parameter new_email cannot be empty.
persistent_id_disabled Void Persistent ID is only available to teams with persistent ID SAML configuration. Please contact Dropbox for more information.
persistent_id_used_by_other_user Void The persistent ID is already in use by another team member.
directory_restricted_off Void Directory Restrictions option is not available.

/members/suspend

Version
Description

Suspend a member from a team.
Permission : Team member management
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.

URL Structure
https://api.dropboxapi.com/2/team/members/suspend
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/suspend \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"},\"wipe_data\": false}"
Parameters
{
    "user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    },
    "wipe_data": false
}
MembersDeactivateArg
user UserSelectorArg Identity of user to remove/suspend/have their files moved.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
wipe_data Boolean If provided, controls if the user's data will be deleted on their linked devices. The default for this field is True.
Returns

No return values.

Errors
Example: user_not_found
{
    "error_summary": "user_not_found/...",
    "error": {
        ".tag": "user_not_found"
    }
}
Example: user_not_in_team
{
    "error_summary": "user_not_in_team/...",
    "error": {
        ".tag": "user_not_in_team"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: suspend_inactive_user
{
    "error_summary": "suspend_inactive_user/...",
    "error": {
        ".tag": "suspend_inactive_user"
    }
}
Example: suspend_last_admin
{
    "error_summary": "suspend_last_admin/...",
    "error": {
        ".tag": "suspend_last_admin"
    }
}
Example: team_license_limit
{
    "error_summary": "team_license_limit/...",
    "error": {
        ".tag": "team_license_limit"
    }
}
MembersSuspendError (union)
The value will be one of the following datatypes:
user_not_found Void No matching user found. The provided team_member_id, email, or external_id does not exist on this team.
user_not_in_team Void The user is not a member of the team.
suspend_inactive_user Void The user is not active, so it cannot be suspended.
suspend_last_admin Void The user is the last admin of the team, so it cannot be suspended.
team_license_limit Void Team is full. The organization has no available licenses.

/members/unsuspend

Version
Description

Unsuspend a member from a team.
Permission : Team member management
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.

URL Structure
https://api.dropboxapi.com/2/team/members/unsuspend
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/members/unsuspend \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"user\": {\".tag\": \"team_member_id\",\"team_member_id\": \"dbmid:efgh5678\"}}"
Parameters
{
    "user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
    }
}
MembersUnsuspendArg
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
user UserSelectorArg Identity of user to unsuspend.
UserSelectorArg (union)
Argument for selecting a single user, either by team_member_id, external_id or email. The value will be one of the following datatypes:
team_member_id String
external_id String(max_length=64)
email String(max_length=255, pattern="^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
Returns

No return values.

Errors
Example: user_not_found
{
    "error_summary": "user_not_found/...",
    "error": {
        ".tag": "user_not_found"
    }
}
Example: user_not_in_team
{
    "error_summary": "user_not_in_team/...",
    "error": {
        ".tag": "user_not_in_team"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: unsuspend_non_suspended_member
{
    "error_summary": "unsuspend_non_suspended_member/...",
    "error": {
        ".tag": "unsuspend_non_suspended_member"
    }
}
Example: team_license_limit
{
    "error_summary": "team_license_limit/...",
    "error": {
        ".tag": "team_license_limit"
    }
}
MembersUnsuspendError (union)
The value will be one of the following datatypes:
user_not_found Void No matching user found. The provided team_member_id, email, or external_id does not exist on this team.
user_not_in_team Void The user is not a member of the team.
unsuspend_non_suspended_member Void The user is unsuspended, so it cannot be unsuspended again.
team_license_limit Void Team is full. The organization has no available licenses.

/namespaces/list

Version
Description

Returns a list of all team-accessible namespaces. This list includes team folders, shared folders containing team members, team members' home namespaces, and team members' app folders. Home namespaces and app folders are always owned by this team or members of the team, but shared folders may be owned by other users or other teams. Duplicates may occur in the list.

URL Structure
https://api.dropboxapi.com/2/team/namespaces/list
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/namespaces/list \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"limit\": 1}"
Parameters
{
    "limit": 1
}
TeamNamespacesListArg
limitdeprecated UInt32(min=1, max=1000) Field is deprecated. Specifying a value here has no effect. The default for this field is 1000.
Returns
{
    "namespaces": [
        {
            "name": "Marketing",
            "namespace_id": "123456789",
            "namespace_type": {
                ".tag": "shared_folder"
            }
        },
        {
            "name": "Franz Ferdinand",
            "namespace_id": "123456789",
            "namespace_type": {
                ".tag": "team_member_folder"
            },
            "team_member_id": "dbmid:1234567"
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
TeamNamespacesListResult
Result for namespaces/list.
namespaces List of (NamespaceMetadata) List of all namespaces the team can access.
NamespaceMetadata
Properties of a namespace.
name String The name of this namespace.
namespace_id String(pattern="[-_0-9a-zA-Z:]+") The ID of this namespace.
namespace_type NamespaceType The type of this namespace.
NamespaceType (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
app_folder Void App sandbox folder.
shared_folder Void Shared folder.
team_folder Void Top-level team-owned folder.
team_member_folder Void Team member's home folder.
team_member_id String? If this is a team member or app folder, the ID of the owning team member. Otherwise, this field is not present. This field is optional.
cursor String Pass the cursor into namespaces/list/continue to obtain additional namespaces. Note that duplicate namespaces may be returned.
has_more Boolean Is true if there are additional namespaces that have not been returned yet.
Errors
Example: invalid_arg
{
    "error_summary": "invalid_arg/...",
    "error": {
        ".tag": "invalid_arg"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TeamNamespacesListError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_arg Void Argument passed in is invalid.

/namespaces/list/continue

Version
Description

Once a cursor has been retrieved from namespaces/list, use this to paginate through all team-accessible namespaces. Duplicates may occur in the list.

URL Structure
https://api.dropboxapi.com/2/team/namespaces/list/continue
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/namespaces/list/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
TeamNamespacesListContinueArg
cursor String Indicates from what point to get the next set of team-accessible namespaces.
Returns
{
    "namespaces": [
        {
            "name": "Marketing",
            "namespace_id": "123456789",
            "namespace_type": {
                ".tag": "shared_folder"
            }
        },
        {
            "name": "Franz Ferdinand",
            "namespace_id": "123456789",
            "namespace_type": {
                ".tag": "team_member_folder"
            },
            "team_member_id": "dbmid:1234567"
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
TeamNamespacesListResult
Result for namespaces/list.
namespaces List of (NamespaceMetadata) List of all namespaces the team can access.
NamespaceMetadata
Properties of a namespace.
name String The name of this namespace.
namespace_id String(pattern="[-_0-9a-zA-Z:]+") The ID of this namespace.
namespace_type NamespaceType The type of this namespace.
NamespaceType (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
app_folder Void App sandbox folder.
shared_folder Void Shared folder.
team_folder Void Top-level team-owned folder.
team_member_folder Void Team member's home folder.
team_member_id String? If this is a team member or app folder, the ID of the owning team member. Otherwise, this field is not present. This field is optional.
cursor String Pass the cursor into namespaces/list/continue to obtain additional namespaces. Note that duplicate namespaces may be returned.
has_more Boolean Is true if there are additional namespaces that have not been returned yet.
Errors
Example: invalid_arg
{
    "error_summary": "invalid_arg/...",
    "error": {
        ".tag": "invalid_arg"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: invalid_cursor
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
TeamNamespacesListContinueError (union)
The value will be one of the following datatypes:
invalid_arg Void Argument passed in is invalid.
invalid_cursor Void The cursor is invalid.

/reports/get_activity

Version
Description

Retrieves reporting data about a team's user activity.

URL Structure
https://api.dropboxapi.com/2/team/reports/get_activity
Authentication
Team Authentication
Endpoint format
RPC
Parameters
DateRange
Input arguments that can be provided for most reports.
start_date Timestamp(format="%Y-%m-%d")? Optional starting date (inclusive). This field is optional.
end_date Timestamp(format="%Y-%m-%d")? Optional ending date (exclusive). This field is optional.
Returns
GetActivityReport
Activity Report Result. Each of the items in the storage report is an array of values, one value per day. If there is no data for a day, then the value will be None.
start_date String First date present in the results as 'YYYY-MM-DD' or None.
adds List of (UInt64?) Array of total number of adds by team members. This field is optional.
edits List of (UInt64?) Array of number of edits by team members. If the same user edits the same file multiple times this is counted as a single edit. This field is optional.
deletes List of (UInt64?) Array of total number of deletes by team members. This field is optional.
active_users_28_day List of (UInt64?) Array of the number of users who have been active in the last 28 days. This field is optional.
active_users_7_day List of (UInt64?) Array of the number of users who have been active in the last week. This field is optional.
active_users_1_day List of (UInt64?) Array of the number of users who have been active in the last day. This field is optional.
active_shared_folders_28_day List of (UInt64?) Array of the number of shared folders with some activity in the last 28 days. This field is optional.
active_shared_folders_7_day List of (UInt64?) Array of the number of shared folders with some activity in the last week. This field is optional.
active_shared_folders_1_day List of (UInt64?) Array of the number of shared folders with some activity in the last day. This field is optional.
shared_links_created List of (UInt64?) Array of the number of shared links created. This field is optional.
shared_links_viewed_by_team List of (UInt64?) Array of the number of views by team users to shared links created by the team. This field is optional.
shared_links_viewed_by_outside_user List of (UInt64?) Array of the number of views by users outside of the team to shared links created by the team. This field is optional.
shared_links_viewed_by_not_logged_in List of (UInt64?) Array of the number of views by non-logged-in users to shared links created by the team. This field is optional.
shared_links_viewed_total List of (UInt64?) Array of the total number of views to shared links created by the team. This field is optional.
Errors
DateRangeError (open union)
Errors that can originate from problems in input arguments to reports. The value will be one of the following datatypes. New values may be introduced as our API evolves.

/reports/get_devices

Version
Description

Retrieves reporting data about a team's linked devices.

URL Structure
https://api.dropboxapi.com/2/team/reports/get_devices
Authentication
Team Authentication
Endpoint format
RPC
Parameters
DateRange
Input arguments that can be provided for most reports.
start_date Timestamp(format="%Y-%m-%d")? Optional starting date (inclusive). This field is optional.
end_date Timestamp(format="%Y-%m-%d")? Optional ending date (exclusive). This field is optional.
Returns
GetDevicesReport
Devices Report Result. Contains subsections for different time ranges of activity. Each of the items in each subsection of the storage report is an array of values, one value per day. If there is no data for a day, then the value will be None.
start_date String First date present in the results as 'YYYY-MM-DD' or None.
active_1_day DevicesActive Report of the number of devices active in the last day.
DevicesActive
Each of the items is an array of values, one value per day. The value is the number of devices active within a time window, ending with that day.
If there is no data for a day, then the value will be None.
windows List of (UInt64?) Array of number of linked windows (desktop) clients with activity. This field is optional.
macos List of (UInt64?) Array of number of linked mac (desktop) clients with activity. This field is optional.
linux List of (UInt64?) Array of number of linked linus (desktop) clients with activity. This field is optional.
ios List of (UInt64?) Array of number of linked ios devices with activity. This field is optional.
android List of (UInt64?) Array of number of linked android devices with activity. This field is optional.
other List of (UInt64?) Array of number of other linked devices (blackberry, windows phone, etc) with activity. This field is optional.
total List of (UInt64?) Array of total number of linked clients with activity. This field is optional.
active_7_day DevicesActive Report of the number of devices active in the last 7 days.
DevicesActive
Each of the items is an array of values, one value per day. The value is the number of devices active within a time window, ending with that day.
If there is no data for a day, then the value will be None.
windows List of (UInt64?) Array of number of linked windows (desktop) clients with activity. This field is optional.
macos List of (UInt64?) Array of number of linked mac (desktop) clients with activity. This field is optional.
linux List of (UInt64?) Array of number of linked linus (desktop) clients with activity. This field is optional.
ios List of (UInt64?) Array of number of linked ios devices with activity. This field is optional.
android List of (UInt64?) Array of number of linked android devices with activity. This field is optional.
other List of (UInt64?) Array of number of other linked devices (blackberry, windows phone, etc) with activity. This field is optional.
total List of (UInt64?) Array of total number of linked clients with activity. This field is optional.
active_28_day DevicesActive Report of the number of devices active in the last 28 days.
DevicesActive
Each of the items is an array of values, one value per day. The value is the number of devices active within a time window, ending with that day.
If there is no data for a day, then the value will be None.
windows List of (UInt64?) Array of number of linked windows (desktop) clients with activity. This field is optional.
macos List of (UInt64?) Array of number of linked mac (desktop) clients with activity. This field is optional.
linux List of (UInt64?) Array of number of linked linus (desktop) clients with activity. This field is optional.
ios List of (UInt64?) Array of number of linked ios devices with activity. This field is optional.
android List of (UInt64?) Array of number of linked android devices with activity. This field is optional.
other List of (UInt64?) Array of number of other linked devices (blackberry, windows phone, etc) with activity. This field is optional.
total List of (UInt64?) Array of total number of linked clients with activity. This field is optional.
Errors
DateRangeError (open union)
Errors that can originate from problems in input arguments to reports. The value will be one of the following datatypes. New values may be introduced as our API evolves.

/reports/get_membership

Version
Description

Retrieves reporting data about a team's membership.

URL Structure
https://api.dropboxapi.com/2/team/reports/get_membership
Authentication
Team Authentication
Endpoint format
RPC
Parameters
DateRange
Input arguments that can be provided for most reports.
start_date Timestamp(format="%Y-%m-%d")? Optional starting date (inclusive). This field is optional.
end_date Timestamp(format="%Y-%m-%d")? Optional ending date (exclusive). This field is optional.
Returns
GetMembershipReport
Membership Report Result. Each of the items in the storage report is an array of values, one value per day. If there is no data for a day, then the value will be None.
start_date String First date present in the results as 'YYYY-MM-DD' or None.
team_size List of (UInt64?) Team size, for each day. This field is optional.
pending_invites List of (UInt64?) The number of pending invites to the team, for each day. This field is optional.
members_joined List of (UInt64?) The number of members that joined the team, for each day. This field is optional.
suspended_members List of (UInt64?) The number of suspended team members, for each day. This field is optional.
licenses List of (UInt64?) The total number of licenses the team has, for each day. This field is optional.
Errors
DateRangeError (open union)
Errors that can originate from problems in input arguments to reports. The value will be one of the following datatypes. New values may be introduced as our API evolves.

/reports/get_storage

Version
Description

Retrieves reporting data about a team's storage usage.

URL Structure
https://api.dropboxapi.com/2/team/reports/get_storage
Authentication
Team Authentication
Endpoint format
RPC
Parameters
DateRange
Input arguments that can be provided for most reports.
start_date Timestamp(format="%Y-%m-%d")? Optional starting date (inclusive). This field is optional.
end_date Timestamp(format="%Y-%m-%d")? Optional ending date (exclusive). This field is optional.
Returns
GetStorageReport
Storage Report Result. Each of the items in the storage report is an array of values, one value per day. If there is no data for a day, then the value will be None.
start_date String First date present in the results as 'YYYY-MM-DD' or None.
total_usage List of (UInt64?) Sum of the shared, unshared, and datastore usages, for each day. This field is optional.
shared_usage List of (UInt64?) Array of the combined size (bytes) of team members' shared folders, for each day. This field is optional.
unshared_usage List of (UInt64?) Array of the combined size (bytes) of team members' root namespaces, for each day. This field is optional.
shared_folders List of (UInt64?) Array of the number of shared folders owned by team members, for each day. This field is optional.
member_storage_map List of (List of (StorageBucket)) Array of storage summaries of team members' account sizes. Each storage summary is an array of key, value pairs, where each pair describes a storage bucket. The key indicates the upper bound of the bucket and the value is the number of users in that bucket. There is one such summary per day. If there is no data for a day, the storage summary will be empty.
StorageBucket
Describes the number of users in a specific storage bucket.
bucket String The name of the storage bucket. For example, '1G' is a bucket of users with storage size up to 1 Giga.
users UInt64 The number of people whose storage is in the range of this storage bucket.
Errors
DateRangeError (open union)
Errors that can originate from problems in input arguments to reports. The value will be one of the following datatypes. New values may be introduced as our API evolves.

/team_folder/activate

Version
Description

Sets an archived team folder's status to active.
Permission : Team member file access.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/activate
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/activate \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"team_folder_id\": \"123456789\"}"
Parameters
{
    "team_folder_id": "123456789"
}
TeamFolderIdArg
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
Returns
{
    "team_folder_id": "123456789",
    "name": "Marketing",
    "status": {
        ".tag": "active"
    },
    "is_team_shared_dropbox": false,
    "sync_setting": {
        ".tag": "default"
    },
    "content_sync_settings": [
        {
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "sync_setting": {
                ".tag": "default"
            }
        }
    ]
}
TeamFolderMetadata
Properties of a team folder.
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String The name of the team folder.
status TeamFolderStatus The status of the team folder.
TeamFolderStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
is_team_shared_dropbox Boolean True if this team folder is a shared team root.
sync_setting SyncSetting The sync setting applied to this team folder.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
content_sync_settings List of (ContentSyncSetting) Sync settings applied to contents of this team folder.
ContentSyncSetting
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSetting Setting for this item.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
Errors
TeamFolderActivateError (union)
The value will be one of the following datatypes:
access_error TeamFolderAccessError
TeamFolderAccessError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_team_folder_id Void The team folder ID is invalid.
no_access Void The authenticated app does not have permission to manage that team folder.
status_error TeamFolderInvalidStatusError
TeamFolderInvalidStatusError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The folder is active and the operation did not succeed.
archived Void The folder is archived and the operation did not succeed.
archive_in_progress Void The folder is being archived and the operation did not succeed.
team_shared_dropbox_error TeamFolderTeamSharedDropboxError
TeamFolderTeamSharedDropboxError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disallowed Void This action is not allowed for a shared team root.

/team_folder/archive

Version
Description

Sets an active team folder's status to archived and removes all folder and file members.
Permission : Team member file access.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/archive
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/archive \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"team_folder_id\": \"123456789\",\"force_async_off\": false}"
Parameters
{
    "team_folder_id": "123456789",
    "force_async_off": false
}
TeamFolderArchiveArg
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
force_async_off Boolean Whether to force the archive to happen synchronously. The default for this field is False.
Returns
{
    ".tag": "complete",
    "team_folder_id": "123456789",
    "name": "Marketing",
    "status": {
        ".tag": "active"
    },
    "is_team_shared_dropbox": false,
    "sync_setting": {
        ".tag": "default"
    },
    "content_sync_settings": [
        {
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "sync_setting": {
                ".tag": "default"
            }
        }
    ]
}
Example: async_job_id
{
    ".tag": "async_job_id",
    "async_job_id": "34g93hh34h04y384084"
}
TeamFolderArchiveLaunch (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 TeamFolderMetadata
TeamFolderMetadata
Properties of a team folder.
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String The name of the team folder.
status TeamFolderStatus The status of the team folder.
TeamFolderStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
is_team_shared_dropbox Boolean True if this team folder is a shared team root.
sync_setting SyncSetting The sync setting applied to this team folder.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
content_sync_settings List of (ContentSyncSetting) Sync settings applied to contents of this team folder.
ContentSyncSetting
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSetting Setting for this item.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
Errors
TeamFolderArchiveError (union)
The value will be one of the following datatypes:
access_error TeamFolderAccessError
TeamFolderAccessError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_team_folder_id Void The team folder ID is invalid.
no_access Void The authenticated app does not have permission to manage that team folder.
status_error TeamFolderInvalidStatusError
TeamFolderInvalidStatusError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The folder is active and the operation did not succeed.
archived Void The folder is archived and the operation did not succeed.
archive_in_progress Void The folder is being archived and the operation did not succeed.
team_shared_dropbox_error TeamFolderTeamSharedDropboxError
TeamFolderTeamSharedDropboxError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disallowed Void This action is not allowed for a shared team root.

/team_folder/archive/check

Version
Description

Returns the status of an asynchronous job for archiving a team folder.
Permission : Team member file access.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/archive/check
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/archive/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",
    "team_folder_id": "123456789",
    "name": "Marketing",
    "status": {
        ".tag": "active"
    },
    "is_team_shared_dropbox": false,
    "sync_setting": {
        ".tag": "default"
    },
    "content_sync_settings": [
        {
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "sync_setting": {
                ".tag": "default"
            }
        }
    ]
}
Example: in_progress
{
    ".tag": "in_progress"
}
TeamFolderArchiveJobStatus (union)
The value will be one of the following datatypes:
in_progress Void The asynchronous job is still in progress.
complete TeamFolderMetadata The archive job has finished. The value is the metadata for the resulting team folder.
TeamFolderMetadata
Properties of a team folder.
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String The name of the team folder.
status TeamFolderStatus The status of the team folder.
TeamFolderStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
is_team_shared_dropbox Boolean True if this team folder is a shared team root.
sync_setting SyncSetting The sync setting applied to this team folder.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
content_sync_settings List of (ContentSyncSetting) Sync settings applied to contents of this team folder.
ContentSyncSetting
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSetting Setting for this item.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
failed TeamFolderArchiveError Error occurred while performing an asynchronous job from team_folder/archive.
TeamFolderArchiveError (union)
The value will be one of the following datatypes:
access_error TeamFolderAccessError
TeamFolderAccessError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_team_folder_id Void The team folder ID is invalid.
no_access Void The authenticated app does not have permission to manage that team folder.
status_error TeamFolderInvalidStatusError
TeamFolderInvalidStatusError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The folder is active and the operation did not succeed.
archived Void The folder is archived and the operation did not succeed.
archive_in_progress Void The folder is being archived and the operation did not succeed.
team_shared_dropbox_error TeamFolderTeamSharedDropboxError
TeamFolderTeamSharedDropboxError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disallowed Void This action is not allowed for a shared team root.
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.

/team_folder/create

Version
Description

Creates a new, active, team folder with no members.
Permission : Team member file access.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/create
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/create \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"name\": \"Marketing\",\"sync_setting\": \"not_synced\"}"
Parameters
{
    "name": "Marketing",
    "sync_setting": "not_synced"
}
TeamFolderCreateArg
name String Name for the new team folder.
sync_setting SyncSettingArg? The sync setting to apply to this team folder. Only permitted if the team has team selective sync enabled. This field is optional.
SyncSettingArg (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
Returns
{
    "team_folder_id": "123456789",
    "name": "Marketing",
    "status": {
        ".tag": "active"
    },
    "is_team_shared_dropbox": false,
    "sync_setting": {
        ".tag": "default"
    },
    "content_sync_settings": [
        {
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "sync_setting": {
                ".tag": "default"
            }
        }
    ]
}
TeamFolderMetadata
Properties of a team folder.
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String The name of the team folder.
status TeamFolderStatus The status of the team folder.
TeamFolderStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
is_team_shared_dropbox Boolean True if this team folder is a shared team root.
sync_setting SyncSetting The sync setting applied to this team folder.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
content_sync_settings List of (ContentSyncSetting) Sync settings applied to contents of this team folder.
ContentSyncSetting
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSetting Setting for this item.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
Errors
Example: invalid_folder_name
{
    "error_summary": "invalid_folder_name/...",
    "error": {
        ".tag": "invalid_folder_name"
    }
}
Example: folder_name_already_used
{
    "error_summary": "folder_name_already_used/...",
    "error": {
        ".tag": "folder_name_already_used"
    }
}
Example: folder_name_reserved
{
    "error_summary": "folder_name_reserved/...",
    "error": {
        ".tag": "folder_name_reserved"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TeamFolderCreateError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_folder_name Void The provided name cannot be used.
folder_name_already_used Void There is already a team folder with the provided name.
folder_name_reserved Void The provided name cannot be used because it is reserved.
sync_settings_error SyncSettingsError An error occurred setting the sync settings.
SyncSettingsError (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
path LookupError
LookupError (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? The given path does not satisfy the required path format. Please refer to the Path formats documentation for more information. 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.
unsupported_combination Void Setting this combination of sync settings simultaneously is not supported.
unsupported_configuration Void The specified configuration is not supported.

/team_folder/get_info

Version
Description

Retrieves metadata for team folders.
Permission : Team member file access.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/get_info
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/get_info \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"team_folder_ids\": [\"947182\",\"5819424\",\"852307532\"]}"
Parameters
{
    "team_folder_ids": [
        "947182",
        "5819424",
        "852307532"
    ]
}
TeamFolderIdListArg
team_folder_ids List of (String(pattern="[-_0-9a-zA-Z:]+"), min_items=1) The list of team folder IDs.
Returns
This route returns a list. This means the route can accept a homogenous list of the following types:
TeamFolderGetInfoItem (union)
The value will be one of the following datatypes:
id_not_found String An ID that was provided as a parameter to team_folder/get_info did not match any of the team's team folders.
team_folder_metadata TeamFolderMetadata Properties of a team folder.
TeamFolderMetadata
Properties of a team folder.
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String The name of the team folder.
status TeamFolderStatus The status of the team folder.
TeamFolderStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
is_team_shared_dropbox Boolean True if this team folder is a shared team root.
sync_setting SyncSetting The sync setting applied to this team folder.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
content_sync_settings List of (ContentSyncSetting) Sync settings applied to contents of this team folder.
ContentSyncSetting
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSetting Setting for this item.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
Errors

No errors.

/team_folder/list

Version
Description

Lists all team folders.
Permission : Team member file access.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/list
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/list \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"limit\": 100}"
Parameters
{
    "limit": 100
}
TeamFolderListArg
limit UInt32(min=1, max=1000) The maximum number of results to return per request. The default for this field is 1000.
Returns
{
    "team_folders": [
        {
            "team_folder_id": "123456789",
            "name": "Marketing",
            "status": {
                ".tag": "active"
            },
            "is_team_shared_dropbox": false,
            "sync_setting": {
                ".tag": "default"
            },
            "content_sync_settings": [
                {
                    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
                    "sync_setting": {
                        ".tag": "default"
                    }
                }
            ]
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
TeamFolderListResult
Result for team_folder/list and team_folder/list/continue.
team_folders List of (TeamFolderMetadata) List of all team folders in the authenticated team.
TeamFolderMetadata
Properties of a team folder.
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String The name of the team folder.
status TeamFolderStatus The status of the team folder.
TeamFolderStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
is_team_shared_dropbox Boolean True if this team folder is a shared team root.
sync_setting SyncSetting The sync setting applied to this team folder.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
content_sync_settings List of (ContentSyncSetting) Sync settings applied to contents of this team folder.
ContentSyncSetting
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSetting Setting for this item.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
cursor String Pass the cursor into team_folder/list/continue to obtain additional team folders.
has_more Boolean Is true if there are additional team folders that have not been returned yet. An additional call to team_folder/list/continue can retrieve them.
Errors
TeamFolderListError
access_error TeamFolderAccessError
TeamFolderAccessError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_team_folder_id Void The team folder ID is invalid.
no_access Void The authenticated app does not have permission to manage that team folder.

/team_folder/list/continue

Version
Description

Once a cursor has been retrieved from team_folder/list, use this to paginate through all team folders.
Permission : Team member file access.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/list/continue
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/list/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
TeamFolderListContinueArg
cursor String Indicates from what point to get the next set of team folders.
Returns
{
    "team_folders": [
        {
            "team_folder_id": "123456789",
            "name": "Marketing",
            "status": {
                ".tag": "active"
            },
            "is_team_shared_dropbox": false,
            "sync_setting": {
                ".tag": "default"
            },
            "content_sync_settings": [
                {
                    "id": "id:a4ayc_80_OEAAAAAAAAAXw",
                    "sync_setting": {
                        ".tag": "default"
                    }
                }
            ]
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
TeamFolderListResult
Result for team_folder/list and team_folder/list/continue.
team_folders List of (TeamFolderMetadata) List of all team folders in the authenticated team.
TeamFolderMetadata
Properties of a team folder.
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String The name of the team folder.
status TeamFolderStatus The status of the team folder.
TeamFolderStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
is_team_shared_dropbox Boolean True if this team folder is a shared team root.
sync_setting SyncSetting The sync setting applied to this team folder.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
content_sync_settings List of (ContentSyncSetting) Sync settings applied to contents of this team folder.
ContentSyncSetting
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSetting Setting for this item.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
cursor String Pass the cursor into team_folder/list/continue to obtain additional team folders.
has_more Boolean Is true if there are additional team folders that have not been returned yet. An additional call to team_folder/list/continue can retrieve them.
Errors
Example: invalid_cursor
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TeamFolderListContinueError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_cursor Void The cursor is invalid.

/team_folder/permanently_delete

Version
Description

Permanently deletes an archived team folder.
Permission : Team member file access.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/permanently_delete
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/permanently_delete \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"team_folder_id\": \"123456789\"}"
Parameters
{
    "team_folder_id": "123456789"
}
TeamFolderIdArg
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
Returns

No return values.

Errors
TeamFolderPermanentlyDeleteError (union)
The value will be one of the following datatypes:
access_error TeamFolderAccessError
TeamFolderAccessError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_team_folder_id Void The team folder ID is invalid.
no_access Void The authenticated app does not have permission to manage that team folder.
status_error TeamFolderInvalidStatusError
TeamFolderInvalidStatusError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The folder is active and the operation did not succeed.
archived Void The folder is archived and the operation did not succeed.
archive_in_progress Void The folder is being archived and the operation did not succeed.
team_shared_dropbox_error TeamFolderTeamSharedDropboxError
TeamFolderTeamSharedDropboxError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disallowed Void This action is not allowed for a shared team root.

/team_folder/rename

Version
Description

Changes an active team folder's name.
Permission : Team member file access.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/rename
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/rename \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"team_folder_id\": \"123456789\",\"name\": \"Sales\"}"
Parameters
{
    "team_folder_id": "123456789",
    "name": "Sales"
}
TeamFolderRenameArg
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String New team folder name.
Returns
{
    "team_folder_id": "123456789",
    "name": "Marketing",
    "status": {
        ".tag": "active"
    },
    "is_team_shared_dropbox": false,
    "sync_setting": {
        ".tag": "default"
    },
    "content_sync_settings": [
        {
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "sync_setting": {
                ".tag": "default"
            }
        }
    ]
}
TeamFolderMetadata
Properties of a team folder.
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String The name of the team folder.
status TeamFolderStatus The status of the team folder.
TeamFolderStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
is_team_shared_dropbox Boolean True if this team folder is a shared team root.
sync_setting SyncSetting The sync setting applied to this team folder.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
content_sync_settings List of (ContentSyncSetting) Sync settings applied to contents of this team folder.
ContentSyncSetting
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSetting Setting for this item.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
Errors
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
Example: invalid_folder_name
{
    "error_summary": "invalid_folder_name/...",
    "error": {
        ".tag": "invalid_folder_name"
    }
}
Example: folder_name_already_used
{
    "error_summary": "folder_name_already_used/...",
    "error": {
        ".tag": "folder_name_already_used"
    }
}
Example: folder_name_reserved
{
    "error_summary": "folder_name_reserved/...",
    "error": {
        ".tag": "folder_name_reserved"
    }
}
TeamFolderRenameError (union)
The value will be one of the following datatypes:
access_error TeamFolderAccessError
TeamFolderAccessError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_team_folder_id Void The team folder ID is invalid.
no_access Void The authenticated app does not have permission to manage that team folder.
status_error TeamFolderInvalidStatusError
TeamFolderInvalidStatusError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The folder is active and the operation did not succeed.
archived Void The folder is archived and the operation did not succeed.
archive_in_progress Void The folder is being archived and the operation did not succeed.
team_shared_dropbox_error TeamFolderTeamSharedDropboxError
TeamFolderTeamSharedDropboxError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disallowed Void This action is not allowed for a shared team root.
invalid_folder_name Void The provided folder name cannot be used.
folder_name_already_used Void There is already a team folder with the same name.
folder_name_reserved Void The provided name cannot be used because it is reserved.

/team_folder/update_sync_settings

Version
PREVIEW - may change or disappear without notice
Description

Updates the sync settings on a team folder or its contents. Use of this endpoint requires that the team has team selective sync enabled.

URL Structure
https://api.dropboxapi.com/2/team/team_folder/update_sync_settings
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team/team_folder/update_sync_settings \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"team_folder_id\": \"123456789\",\"sync_setting\": \"not_synced\",\"content_sync_settings\": [{\"id\": \"id:a4ayc_80_OEAAAAAAAAAXw\",\"sync_setting\": \"not_synced\"}]}"
Parameters
{
    "team_folder_id": "123456789",
    "sync_setting": "not_synced",
    "content_sync_settings": [
        {
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "sync_setting": "not_synced"
        }
    ]
}
TeamFolderUpdateSyncSettingsArg
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
sync_setting SyncSettingArg? Sync setting to apply to the team folder itself. Only meaningful if the team folder is not a shared team root. This field is optional.
SyncSettingArg (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
content_sync_settings List of (ContentSyncSettingArg)? Sync settings to apply to contents of this team folder. This field is optional.
ContentSyncSettingArg
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSettingArg Setting for this item.
SyncSettingArg (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
Returns
{
    "team_folder_id": "123456789",
    "name": "Marketing",
    "status": {
        ".tag": "active"
    },
    "is_team_shared_dropbox": false,
    "sync_setting": {
        ".tag": "default"
    },
    "content_sync_settings": [
        {
            "id": "id:a4ayc_80_OEAAAAAAAAAXw",
            "sync_setting": {
                ".tag": "default"
            }
        }
    ]
}
TeamFolderMetadata
Properties of a team folder.
team_folder_id String(pattern="[-_0-9a-zA-Z:]+") The ID of the team folder.
name String The name of the team folder.
status TeamFolderStatus The status of the team folder.
TeamFolderStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
is_team_shared_dropbox Boolean True if this team folder is a shared team root.
sync_setting SyncSetting The sync setting applied to this team folder.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
content_sync_settings List of (ContentSyncSetting) Sync settings applied to contents of this team folder.
ContentSyncSetting
This datatype comes from an imported namespace originally defined in the files namespace.
id String(min_length=4, pattern="id:.+") Id of the item this setting is applied to.
sync_setting SyncSetting Setting for this item.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
Errors
TeamFolderUpdateSyncSettingsError (union)
The value will be one of the following datatypes:
access_error TeamFolderAccessError
TeamFolderAccessError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
invalid_team_folder_id Void The team folder ID is invalid.
no_access Void The authenticated app does not have permission to manage that team folder.
status_error TeamFolderInvalidStatusError
TeamFolderInvalidStatusError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The folder is active and the operation did not succeed.
archived Void The folder is archived and the operation did not succeed.
archive_in_progress Void The folder is being archived and the operation did not succeed.
team_shared_dropbox_error TeamFolderTeamSharedDropboxError
TeamFolderTeamSharedDropboxError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disallowed Void This action is not allowed for a shared team root.
sync_settings_error SyncSettingsError An error occurred setting the sync settings.
SyncSettingsError (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
path LookupError
LookupError (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
malformed_path String? The given path does not satisfy the required path format. Please refer to the Path formats documentation for more information. 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.
unsupported_combination Void Setting this combination of sync settings simultaneously is not supported.
unsupported_configuration Void The specified configuration is not supported.

/token/get_authenticated_admin

Version
Description

Returns the member profile of the admin who generated the team access token used to make the call.

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

No parameters.

Returns
{
    "admin_profile": {
        "team_member_id": "dbmid:FDFSVF-DFSDF",
        "email": "tami@seagull.com",
        "email_verified": false,
        "status": {
            ".tag": "active"
        },
        "name": {
            "given_name": "Franz",
            "surname": "Ferdinand",
            "familiar_name": "Franz",
            "display_name": "Franz Ferdinand (Personal)",
            "abbreviated_name": "FF"
        },
        "membership_type": {
            ".tag": "full"
        },
        "groups": [
            "g:e2db7665347abcd600000000001a2b3c"
        ],
        "member_folder_id": "20",
        "external_id": "244423",
        "account_id": "dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc",
        "joined_on": "2015-05-12T15:50:38Z"
    }
}
TokenGetAuthenticatedAdminResult
Results for token/get_authenticated_admin.
admin_profile TeamMemberProfile The admin who authorized the token.
TeamMemberProfile
Profile of a user as a member of a team.
team_member_id String ID of user as a member of a team.
email String Email address of user.
email_verified Boolean Is true if the user's email is verified to be owned by the user.
status TeamMemberStatus The user's status as a member of a specific team.
TeamMemberStatus (union)
The user's status as a member of a specific team. The value will be one of the following datatypes:
active Void User has successfully joined the team.
invited Void User has been invited to a team, but has not joined the team yet.
suspended Void User is no longer a member of the team, but the account can be un-suspended, re-establishing the user as a team member.
removed RemovedStatus User is no longer a member of the team. Removed users are only listed when include_removed is true in members/list.
RemovedStatus
is_recoverable Boolean True if the removed team member is recoverable.
is_disconnected Boolean True if the team member's account was converted to individual account.
name Name Representations for a person's name.
Name
Representations for a person's name to assist with internationalization. This datatype comes from an imported namespace originally defined in the users namespace.
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.
membership_type TeamMembershipType The user's membership type: full (normal team member) vs limited (does not use a license; no access to the team's shared quota).
TeamMembershipType (union)
The value will be one of the following datatypes:
full Void User uses a license and has full access to team resources like the shared quota.
limited Void User does not have access to the shared quota and team admins have restricted administrative control.
groups List of (String) List of group IDs of groups that the user belongs to.
member_folder_id String(pattern="[-_0-9a-zA-Z:]+") The namespace id of the user's root folder.
external_id String? External ID that a team can attach to the user. An application using the API may find it easier to use their own IDs instead of Dropbox IDs like account_id or team_member_id. This field is optional.
account_id String(min_length=40, max_length=40)? A user's account identifier. This field is optional.
joined_on Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The date and time the user joined as a member of a specific team. This field is optional.
persistent_id String? Persistent ID that a team can attach to the user. The persistent ID is unique ID to be used for SAML authentication. This field is optional.
is_directory_restricted Boolean? Whether the user is a directory restricted user. This field is optional.
Errors
Example: mapping_not_found
{
    "error_summary": "mapping_not_found/...",
    "error": {
        ".tag": "mapping_not_found"
    }
}
Example: admin_not_active
{
    "error_summary": "admin_not_active/...",
    "error": {
        ".tag": "admin_not_active"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TokenGetAuthenticatedAdminError (open union)
Error returned by token/get_authenticated_admin. The value will be one of the following datatypes. New values may be introduced as our API evolves.
mapping_not_found Void The current token is not associated with a team admin, because mappings were not recorded when the token was created. Consider re-authorizing a new access token to record its authenticating admin.
admin_not_active Void Either the team admin that authorized this token is no longer an active member of the team or no longer a team admin.

team_log

/get_events

Version
Description

Retrieves team events.
Events have a lifespan of two years. Events older than two years will not be returned.
Many attributes note 'may be missing due to historical data gap'.
Note that the file_operations category and & analogous paper events are not available on all Dropbox Business plans. Use features/get_values to check for this feature.
Permission : Team Auditing.

URL Structure
https://api.dropboxapi.com/2/team_log/get_events
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team_log/get_events \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"limit\": 50,\"category\": \"groups\"}"
Parameters
{
    "limit": 50,
    "category": "groups"
}
GetTeamEventsArg
limit UInt32(min=1, max=1000) The maximal number of results to return per call. Note that some calls may not return limit number of events, and may even return no events, even with `has_more` set to true. In this case, callers should fetch again using get_events/continue. The default for this field is 1000.
account_id String(min_length=40, max_length=40)? Filter the events by account ID. Return ony events with this account_id as either Actor, Context, or Participants. This field is optional.
time TimeRange? Filter by time range. This field is optional.
TimeRange
Time range. This datatype comes from an imported namespace originally defined in the team_common namespace.
start_time Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Optional starting time (inclusive). This field is optional.
end_time Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Optional ending time (exclusive). This field is optional.
category EventCategory? Filter the returned events to a single category. This field is optional.
EventCategory (open union)
Category of events in event audit log. The value will be one of the following datatypes. New values may be introduced as our API evolves.
apps Void Events that apply to management of linked apps.
comments Void Events that have to do with comments on files and Paper documents.
devices Void Events that apply to linked devices on mobile, desktop and Web platforms.
domains Void Events that involve domain management feature: domain verification, invite enforcement and account capture.
file_operations Void Events that have to do with filesystem operations on files and folders: copy, move, delete, etc.
file_requests Void Events that apply to the file requests feature.
groups Void Events that involve group management.
logins Void Events that involve users signing in to or out of Dropbox.
members Void Events that involve team member management.
paper Void Events that apply to Dropbox Paper.
passwords Void Events that involve using, changing or resetting passwords.
reports Void Events that concern generation of admin reports, including team activity and device usage.
sharing Void Events that apply to all types of sharing and collaboration.
showcase Void Events that apply to Dropbox Showcase.
sso Void Events that involve using or configuring single sign-on as well as administrative policies concerning single sign-on.
team_folders Void Events that involve team folder management.
team_policies Void Events that involve a change in team-wide policies.
team_profile Void Events that involve a change in the team profile.
tfa Void Events that involve using or configuring two factor authentication as well as administrative policies concerning two factor authentication.
Returns
{
    "events": [
        {
            "timestamp": "2017-01-25T15:51:30Z",
            "event_category": {
                ".tag": "tfa"
            },
            "event_type": {
                ".tag": "shared_content_download",
                "description": "(sharing) Downloaded shared file/folder"
            },
            "details": {
                ".tag": "shared_content_download_details",
                "shared_content_link": "abc",
                "shared_content_access_level": {
                    ".tag": "viewer_no_comment"
                },
                "shared_content_owner": {
                    ".tag": "team_member",
                    "account_id": "dbid:AAHgR8xsQP48a5DQUGPo-Vxsrjd0OByVmho",
                    "display_name": "John Smith",
                    "email": "john_smith@acmecorp.com",
                    "team_member_id": "dbmid:AAFoi-tmvRuQR0jU-3fN4B-9nZo6nHcDO9Q",
                    "member_external_id": "ADSYNC S-1-5-21-1004296348-1135238915-682003432-1224"
                }
            },
            "actor": {
                ".tag": "user",
                "user": {
                    ".tag": "team_member",
                    "account_id": "dbid:AAHgR8xsQP48a5DQUGPo-Vxsrjd0OByVmho",
                    "display_name": "John Smith",
                    "email": "john_smith@acmecorp.com",
                    "team_member_id": "dbmid:AAFoi-tmvRuQR0jU-3fN4B-9nZo6nHcDO9Q",
                    "member_external_id": "ADSYNC S-1-5-21-1004296348-1135238915-682003432-1224"
                }
            },
            "origin": {
                "access_method": {
                    ".tag": "end_user",
                    "end_user": {
                        ".tag": "web",
                        "session_id": "dbwsid:123456789012345678901234567890123456789"
                    }
                },
                "geo_location": {
                    "ip_address": "45.56.78.100",
                    "city": "San Francisco",
                    "region": "California",
                    "country": "US"
                }
            },
            "involve_non_team_member": true,
            "context": {
                ".tag": "team_member",
                "account_id": "dbid:AAHgR8xsQP48a5DQUGPo-Vxsrjd0OByVmho",
                "display_name": "John Smith",
                "email": "john_smith@acmecorp.com",
                "team_member_id": "dbmid:AAFoi-tmvRuQR0jU-3fN4B-9nZo6nHcDO9Q",
                "member_external_id": "ADSYNC S-1-5-21-1004296348-1135238915-682003432-1224"
            },
            "participants": [
                {
                    ".tag": "user",
                    "user": {
                        ".tag": "team_member",
                        "account_id": "dbid:AAGx4oiLtHdvRdNxUpvvJBXYgR4BS19c9kw",
                        "display_name": "Jane Smith",
                        "email": "jane_smith@acmecorp.com",
                        "team_member_id": "dbmid:AAFoi-tmvRuQR0jU-3fN4B-9nZo6nHcDO9Q",
                        "member_external_id": "ADSYNC S-1-5-21-1004296348-1135238915-682003432-1225"
                    }
                }
            ],
            "assets": [
                {
                    ".tag": "file",
                    "path": {
                        "namespace_relative": {
                            "ns_id": "1234",
                            "relative_path": "/Contract Work/Draft"
                        },
                        "contextual": "/Contract Work/Draft"
                    },
                    "display_name": "reports.xls",
                    "file_id": "id:jQKLsZFQImAAAAAAEZAAQt"
                }
            ]
        }
    ],
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
    "has_more": false
}
GetTeamEventsResult
events List of (TeamEvent) List of events. Note that events are not guaranteed to be sorted by their timestamp value.
TeamEvent
An audit log event.
timestamp Timestamp(format="%Y-%m-%dT%H:%M:%SZ") The Dropbox timestamp representing when the action was taken.
event_category EventCategory The category that this type of action belongs to.
EventCategory (open union)
Category of events in event audit log. The value will be one of the following datatypes. New values may be introduced as our API evolves.
apps Void Events that apply to management of linked apps.
comments Void Events that have to do with comments on files and Paper documents.
devices Void Events that apply to linked devices on mobile, desktop and Web platforms.
domains Void Events that involve domain management feature: domain verification, invite enforcement and account capture.
file_operations Void Events that have to do with filesystem operations on files and folders: copy, move, delete, etc.
file_requests Void Events that apply to the file requests feature.
groups Void Events that involve group management.
logins Void Events that involve users signing in to or out of Dropbox.
members Void Events that involve team member management.
paper Void Events that apply to Dropbox Paper.
passwords Void Events that involve using, changing or resetting passwords.
reports Void Events that concern generation of admin reports, including team activity and device usage.
sharing Void Events that apply to all types of sharing and collaboration.
showcase Void Events that apply to Dropbox Showcase.
sso Void Events that involve using or configuring single sign-on as well as administrative policies concerning single sign-on.
team_folders Void Events that involve team folder management.
team_policies Void Events that involve a change in team-wide policies.
team_profile Void Events that involve a change in the team profile.
tfa Void Events that involve using or configuring two factor authentication as well as administrative policies concerning two factor authentication.
event_type EventType The particular type of action taken.
EventType (open union)
The type of the event. The value will be one of the following datatypes. New values may be introduced as our API evolves.
app_link_team AppLinkTeamType (apps) Linked app for team
AppLinkTeamType
description String
app_link_user AppLinkUserType (apps) Linked app for member
AppLinkUserType
description String
app_unlink_team AppUnlinkTeamType (apps) Unlinked app for team
AppUnlinkTeamType
description String
app_unlink_user AppUnlinkUserType (apps) Unlinked app for member
AppUnlinkUserType
description String
file_add_comment FileAddCommentType (comments) Added file comment
FileAddCommentType
description String
file_change_comment_subscription FileChangeCommentSubscriptionType (comments) Subscribed to or unsubscribed from comment notifications for file
FileChangeCommentSubscriptionType
description String
file_delete_comment FileDeleteCommentType (comments) Deleted file comment
FileDeleteCommentType
description String
file_like_comment FileLikeCommentType (comments) Liked file comment (deprecated, no longer logged)
FileLikeCommentType
description String
file_resolve_comment FileResolveCommentType (comments) Resolved file comment
FileResolveCommentType
description String
file_unlike_comment FileUnlikeCommentType (comments) Unliked file comment (deprecated, no longer logged)
FileUnlikeCommentType
description String
file_unresolve_comment FileUnresolveCommentType (comments) Unresolved file comment
FileUnresolveCommentType
description String
device_change_ip_desktop DeviceChangeIpDesktopType (devices) Changed IP address associated with active desktop session
DeviceChangeIpDesktopType
description String
device_change_ip_mobile DeviceChangeIpMobileType (devices) Changed IP address associated with active mobile session
DeviceChangeIpMobileType
description String
device_change_ip_web DeviceChangeIpWebType (devices) Changed IP address associated with active web session
DeviceChangeIpWebType
description String
device_delete_on_unlink_fail DeviceDeleteOnUnlinkFailType (devices) Failed to delete all files from unlinked device
DeviceDeleteOnUnlinkFailType
description String
device_delete_on_unlink_success DeviceDeleteOnUnlinkSuccessType (devices) Deleted all files from unlinked device
DeviceDeleteOnUnlinkSuccessType
description String
device_link_fail DeviceLinkFailType (devices) Failed to link device
DeviceLinkFailType
description String
device_link_success DeviceLinkSuccessType (devices) Linked device
DeviceLinkSuccessType
description String
device_management_disabled DeviceManagementDisabledType (devices) Disabled device management (deprecated, no longer logged)
DeviceManagementDisabledType
description String
device_management_enabled DeviceManagementEnabledType (devices) Enabled device management (deprecated, no longer logged)
DeviceManagementEnabledType
description String
device_unlink DeviceUnlinkType (devices) Disconnected device
DeviceUnlinkType
description String
emm_refresh_auth_token EmmRefreshAuthTokenType (devices) Refreshed auth token used for setting up enterprise mobility management
EmmRefreshAuthTokenType
description String
account_capture_change_availability AccountCaptureChangeAvailabilityType (domains) Granted/revoked option to enable account capture on team domains
AccountCaptureChangeAvailabilityType
description String
account_capture_migrate_account AccountCaptureMigrateAccountType (domains) Account-captured user migrated account to team
AccountCaptureMigrateAccountType
description String
account_capture_notification_emails_sent AccountCaptureNotificationEmailsSentType (domains) Sent proactive account capture email to all unmanaged members
AccountCaptureNotificationEmailsSentType
description String
account_capture_relinquish_account AccountCaptureRelinquishAccountType (domains) Account-captured user changed account email to personal email
AccountCaptureRelinquishAccountType
description String
disabled_domain_invites DisabledDomainInvitesType (domains) Disabled domain invites (deprecated, no longer logged)
DisabledDomainInvitesType
description String
domain_invites_approve_request_to_join_team DomainInvitesApproveRequestToJoinTeamType (domains) Approved user's request to join team
DomainInvitesApproveRequestToJoinTeamType
description String
domain_invites_decline_request_to_join_team DomainInvitesDeclineRequestToJoinTeamType (domains) Declined user's request to join team
DomainInvitesDeclineRequestToJoinTeamType
description String
domain_invites_email_existing_users DomainInvitesEmailExistingUsersType (domains) Sent domain invites to existing domain accounts (deprecated, no longer logged)
DomainInvitesEmailExistingUsersType
description String
domain_invites_request_to_join_team DomainInvitesRequestToJoinTeamType (domains) Requested to join team
DomainInvitesRequestToJoinTeamType
description String
domain_invites_set_invite_new_user_pref_to_no DomainInvitesSetInviteNewUserPrefToNoType (domains) Disabled "Automatically invite new users" (deprecated, no longer logged)
DomainInvitesSetInviteNewUserPrefToNoType
description String
domain_invites_set_invite_new_user_pref_to_yes DomainInvitesSetInviteNewUserPrefToYesType (domains) Enabled "Automatically invite new users" (deprecated, no longer logged)
DomainInvitesSetInviteNewUserPrefToYesType
description String
domain_verification_add_domain_fail DomainVerificationAddDomainFailType (domains) Failed to verify team domain
DomainVerificationAddDomainFailType
description String
domain_verification_add_domain_success DomainVerificationAddDomainSuccessType (domains) Verified team domain
DomainVerificationAddDomainSuccessType
description String
domain_verification_remove_domain DomainVerificationRemoveDomainType (domains) Removed domain from list of verified team domains
DomainVerificationRemoveDomainType
description String
enabled_domain_invites EnabledDomainInvitesType (domains) Enabled domain invites (deprecated, no longer logged)
EnabledDomainInvitesType
description String
create_folder CreateFolderType (file_operations) Created folders (deprecated, no longer logged)
CreateFolderType
description String
file_add FileAddType (file_operations) Added files and/or folders
FileAddType
description String
file_copy FileCopyType (file_operations) Copied files and/or folders
FileCopyType
description String
file_delete FileDeleteType (file_operations) Deleted files and/or folders
FileDeleteType
description String
file_download FileDownloadType (file_operations) Downloaded files and/or folders
FileDownloadType
description String
file_edit FileEditType (file_operations) Edited files
FileEditType
description String
file_get_copy_reference FileGetCopyReferenceType (file_operations) Created copy reference to file/folder
FileGetCopyReferenceType
description String
file_move FileMoveType (file_operations) Moved files and/or folders
FileMoveType
description String
file_permanently_delete FilePermanentlyDeleteType (file_operations) Permanently deleted files and/or folders
FilePermanentlyDeleteType
description String
file_preview FilePreviewType (file_operations) Previewed files and/or folders
FilePreviewType
description String
file_rename FileRenameType (file_operations) Renamed files and/or folders
FileRenameType
description String
file_restore FileRestoreType (file_operations) Restored deleted files and/or folders
FileRestoreType
description String
file_revert FileRevertType (file_operations) Reverted files to previous version
FileRevertType
description String
file_rollback_changes FileRollbackChangesType (file_operations) Rolled back file actions
FileRollbackChangesType
description String
file_save_copy_reference FileSaveCopyReferenceType (file_operations) Saved file/folder using copy reference
FileSaveCopyReferenceType
description String
file_request_change FileRequestChangeType (file_requests) Changed file request
FileRequestChangeType
description String
file_request_close FileRequestCloseType (file_requests) Closed file request
FileRequestCloseType
description String
file_request_create FileRequestCreateType (file_requests) Created file request
FileRequestCreateType
description String
file_request_receive_file FileRequestReceiveFileType (file_requests) Received files for file request
FileRequestReceiveFileType
description String
group_add_external_id GroupAddExternalIdType (groups) Added external ID for group
GroupAddExternalIdType
description String
group_add_member GroupAddMemberType (groups) Added team members to group
GroupAddMemberType
description String
group_change_external_id GroupChangeExternalIdType (groups) Changed external ID for group
GroupChangeExternalIdType
description String
group_change_management_type GroupChangeManagementTypeType (groups) Changed group management type
GroupChangeManagementTypeType
description String
group_change_member_role GroupChangeMemberRoleType (groups) Changed manager permissions of group member
GroupChangeMemberRoleType
description String
group_create GroupCreateType (groups) Created group
GroupCreateType
description String
group_delete GroupDeleteType (groups) Deleted group
GroupDeleteType
description String
group_description_updated GroupDescriptionUpdatedType (groups) Updated group (deprecated, no longer logged)
GroupDescriptionUpdatedType
description String
group_join_policy_updated GroupJoinPolicyUpdatedType (groups) Updated group join policy (deprecated, no longer logged)
GroupJoinPolicyUpdatedType
description String
group_moved GroupMovedType (groups) Moved group (deprecated, no longer logged)
GroupMovedType
description String
group_remove_external_id GroupRemoveExternalIdType (groups) Removed external ID for group
GroupRemoveExternalIdType
description String
group_remove_member GroupRemoveMemberType (groups) Removed team members from group
GroupRemoveMemberType
description String
group_rename GroupRenameType (groups) Renamed group
GroupRenameType
description String
emm_error EmmErrorType (logins) Failed to sign in via EMM (deprecated, replaced by 'Failed to sign in')
EmmErrorType
description String
login_fail LoginFailType (logins) Failed to sign in
LoginFailType
description String
login_success LoginSuccessType (logins) Signed in
LoginSuccessType
description String
logout LogoutType (logins) Signed out
LogoutType
description String
reseller_support_session_end ResellerSupportSessionEndType (logins) Ended reseller support session
ResellerSupportSessionEndType
description String
reseller_support_session_start ResellerSupportSessionStartType (logins) Started reseller support session
ResellerSupportSessionStartType
description String
sign_in_as_session_end SignInAsSessionEndType (logins) Ended admin sign-in-as session
SignInAsSessionEndType
description String
sign_in_as_session_start SignInAsSessionStartType (logins) Started admin sign-in-as session
SignInAsSessionStartType
description String
sso_error SsoErrorType (logins) Failed to sign in via SSO (deprecated, replaced by 'Failed to sign in')
SsoErrorType
description String
member_add_name MemberAddNameType (members) Added team member name
MemberAddNameType
description String
member_change_admin_role MemberChangeAdminRoleType (members) Changed team member admin role
MemberChangeAdminRoleType
description String
member_change_email MemberChangeEmailType (members) Changed team member email
MemberChangeEmailType
description String
member_change_membership_type MemberChangeMembershipTypeType (members) Changed membership type (limited/full) of member (deprecated, no longer logged)
MemberChangeMembershipTypeType
description String
member_change_name MemberChangeNameType (members) Changed team member name
MemberChangeNameType
description String
member_change_status MemberChangeStatusType (members) Changed member status (invited, joined, suspended, etc.)
MemberChangeStatusType
description String
member_delete_manual_contacts MemberDeleteManualContactsType (members) Cleared manually added contacts
MemberDeleteManualContactsType
description String
member_permanently_delete_account_contents MemberPermanentlyDeleteAccountContentsType (members) Permanently deleted contents of deleted team member account
MemberPermanentlyDeleteAccountContentsType
description String
member_space_limits_add_custom_quota MemberSpaceLimitsAddCustomQuotaType (members) Set custom member space limit
MemberSpaceLimitsAddCustomQuotaType
description String
member_space_limits_change_custom_quota MemberSpaceLimitsChangeCustomQuotaType (members) Changed custom member space limit
MemberSpaceLimitsChangeCustomQuotaType
description String
member_space_limits_change_status MemberSpaceLimitsChangeStatusType (members) Changed space limit status
MemberSpaceLimitsChangeStatusType
description String
member_space_limits_remove_custom_quota MemberSpaceLimitsRemoveCustomQuotaType (members) Removed custom member space limit
MemberSpaceLimitsRemoveCustomQuotaType
description String
member_suggest MemberSuggestType (members) Suggested person to add to team
MemberSuggestType
description String
member_transfer_account_contents MemberTransferAccountContentsType (members) Transferred contents of deleted member account to another member
MemberTransferAccountContentsType
description String
secondary_mails_policy_changed SecondaryMailsPolicyChangedType (members) Secondary mails policy changed
SecondaryMailsPolicyChangedType
description String
paper_content_add_member PaperContentAddMemberType (paper) Added team member to Paper doc/folder
PaperContentAddMemberType
description String
paper_content_add_to_folder PaperContentAddToFolderType (paper) Added Paper doc/folder to folder
PaperContentAddToFolderType
description String
paper_content_archive PaperContentArchiveType (paper) Archived Paper doc/folder
PaperContentArchiveType
description String
paper_content_create PaperContentCreateType (paper) Created Paper doc/folder
PaperContentCreateType
description String
paper_content_permanently_delete PaperContentPermanentlyDeleteType (paper) Permanently deleted Paper doc/folder
PaperContentPermanentlyDeleteType
description String
paper_content_remove_from_folder PaperContentRemoveFromFolderType (paper) Removed Paper doc/folder from folder
PaperContentRemoveFromFolderType
description String
paper_content_remove_member PaperContentRemoveMemberType (paper) Removed team member from Paper doc/folder
PaperContentRemoveMemberType
description String
paper_content_rename PaperContentRenameType (paper) Renamed Paper doc/folder
PaperContentRenameType
description String
paper_content_restore PaperContentRestoreType (paper) Restored archived Paper doc/folder
PaperContentRestoreType
description String
paper_doc_add_comment PaperDocAddCommentType (paper) Added Paper doc comment
PaperDocAddCommentType
description String
paper_doc_change_member_role PaperDocChangeMemberRoleType (paper) Changed team member permissions for Paper doc
PaperDocChangeMemberRoleType
description String
paper_doc_change_sharing_policy PaperDocChangeSharingPolicyType (paper) Changed sharing setting for Paper doc
PaperDocChangeSharingPolicyType
description String
paper_doc_change_subscription PaperDocChangeSubscriptionType (paper) Followed/unfollowed Paper doc
PaperDocChangeSubscriptionType
description String
paper_doc_deleted PaperDocDeletedType (paper) Archived Paper doc (deprecated, no longer logged)
PaperDocDeletedType
description String
paper_doc_delete_comment PaperDocDeleteCommentType (paper) Deleted Paper doc comment
PaperDocDeleteCommentType
description String
paper_doc_download PaperDocDownloadType (paper) Downloaded Paper doc in specific format
PaperDocDownloadType
description String
paper_doc_edit PaperDocEditType (paper) Edited Paper doc
PaperDocEditType
description String
paper_doc_edit_comment PaperDocEditCommentType (paper) Edited Paper doc comment
PaperDocEditCommentType
description String
paper_doc_followed PaperDocFollowedType (paper) Followed Paper doc (deprecated, replaced by 'Followed/unfollowed Paper doc')
PaperDocFollowedType
description String
paper_doc_mention PaperDocMentionType (paper) Mentioned team member in Paper doc
PaperDocMentionType
description String
paper_doc_ownership_changed PaperDocOwnershipChangedType (paper) Transferred ownership of Paper doc
PaperDocOwnershipChangedType
description String
paper_doc_request_access PaperDocRequestAccessType (paper) Requested access to Paper doc
PaperDocRequestAccessType
description String
paper_doc_resolve_comment PaperDocResolveCommentType (paper) Resolved Paper doc comment
PaperDocResolveCommentType
description String
paper_doc_revert PaperDocRevertType (paper) Restored Paper doc to previous version
PaperDocRevertType
description String
paper_doc_slack_share PaperDocSlackShareType (paper) Shared Paper doc via Slack
PaperDocSlackShareType
description String
paper_doc_team_invite PaperDocTeamInviteType (paper) Shared Paper doc with team member (deprecated, no longer logged)
PaperDocTeamInviteType
description String
paper_doc_trashed PaperDocTrashedType (paper) Deleted Paper doc
PaperDocTrashedType
description String
paper_doc_unresolve_comment PaperDocUnresolveCommentType (paper) Unresolved Paper doc comment
PaperDocUnresolveCommentType
description String
paper_doc_untrashed PaperDocUntrashedType (paper) Restored Paper doc
PaperDocUntrashedType
description String
paper_doc_view PaperDocViewType (paper) Viewed Paper doc
PaperDocViewType
description String
paper_external_view_allow PaperExternalViewAllowType (paper) Changed Paper external sharing setting to anyone (deprecated, no longer logged)
PaperExternalViewAllowType
description String
paper_external_view_default_team PaperExternalViewDefaultTeamType (paper) Changed Paper external sharing setting to default team (deprecated, no longer logged)
PaperExternalViewDefaultTeamType
description String
paper_external_view_forbid PaperExternalViewForbidType (paper) Changed Paper external sharing setting to team-only (deprecated, no longer logged)
PaperExternalViewForbidType
description String
paper_folder_change_subscription PaperFolderChangeSubscriptionType (paper) Followed/unfollowed Paper folder
PaperFolderChangeSubscriptionType
description String
paper_folder_deleted PaperFolderDeletedType (paper) Archived Paper folder (deprecated, no longer logged)
PaperFolderDeletedType
description String
paper_folder_followed PaperFolderFollowedType (paper) Followed Paper folder (deprecated, replaced by 'Followed/unfollowed Paper folder')
PaperFolderFollowedType
description String
paper_folder_team_invite PaperFolderTeamInviteType (paper) Shared Paper folder with member (deprecated, no longer logged)
PaperFolderTeamInviteType
description String
password_change PasswordChangeType (passwords) Changed password
PasswordChangeType
description String
password_reset PasswordResetType (passwords) Reset password
PasswordResetType
description String
password_reset_all PasswordResetAllType (passwords) Reset all team member passwords
PasswordResetAllType
description String
emm_create_exceptions_report EmmCreateExceptionsReportType (reports) Created EMM-excluded users report
EmmCreateExceptionsReportType
description String
emm_create_usage_report EmmCreateUsageReportType (reports) Created EMM mobile app usage report
EmmCreateUsageReportType
description String
export_members_report ExportMembersReportType (reports) Created member data report
ExportMembersReportType
description String
paper_admin_export_start PaperAdminExportStartType (reports) Exported all team Paper docs
PaperAdminExportStartType
description String
smart_sync_create_admin_privilege_report SmartSyncCreateAdminPrivilegeReportType (reports) Created Smart Sync non-admin devices report
SmartSyncCreateAdminPrivilegeReportType
description String
team_activity_create_report TeamActivityCreateReportType (reports) Created team activity report
TeamActivityCreateReportType
description String
collection_share CollectionShareType (sharing) Shared album
CollectionShareType
description String
note_acl_invite_only NoteAclInviteOnlyType (sharing) Changed Paper doc to invite-only (deprecated, no longer logged)
NoteAclInviteOnlyType
description String
note_acl_link NoteAclLinkType (sharing) Changed Paper doc to link-accessible (deprecated, no longer logged)
NoteAclLinkType
description String
note_acl_team_link NoteAclTeamLinkType (sharing) Changed Paper doc to link-accessible for team (deprecated, no longer logged)
NoteAclTeamLinkType
description String
note_shared NoteSharedType (sharing) Shared Paper doc (deprecated, no longer logged)
NoteSharedType
description String
note_share_receive NoteShareReceiveType (sharing) Shared received Paper doc (deprecated, no longer logged)
NoteShareReceiveType
description String
open_note_shared OpenNoteSharedType (sharing) Opened shared Paper doc (deprecated, no longer logged)
OpenNoteSharedType
description String
sf_add_group SfAddGroupType (sharing) Added team to shared folder (deprecated, no longer logged)
SfAddGroupType
description String
sf_allow_non_members_to_view_shared_links SfAllowNonMembersToViewSharedLinksType (sharing) Allowed non-collaborators to view links to files in shared folder (deprecated, no longer logged)
SfAllowNonMembersToViewSharedLinksType
description String
sf_external_invite_warn SfExternalInviteWarnType (sharing) Set team members to see warning before sharing folders outside team (deprecated, no longer logged)
SfExternalInviteWarnType
description String
sf_fb_invite SfFbInviteType (sharing) Invited Facebook users to shared folder (deprecated, no longer logged)
SfFbInviteType
description String
sf_fb_invite_change_role SfFbInviteChangeRoleType (sharing) Changed Facebook user's role in shared folder (deprecated, no longer logged)
SfFbInviteChangeRoleType
description String
sf_fb_uninvite SfFbUninviteType (sharing) Uninvited Facebook user from shared folder (deprecated, no longer logged)
SfFbUninviteType
description String
sf_invite_group SfInviteGroupType (sharing) Invited group to shared folder (deprecated, no longer logged)
SfInviteGroupType
description String
sf_team_grant_access SfTeamGrantAccessType (sharing) Granted access to shared folder (deprecated, no longer logged)
SfTeamGrantAccessType
description String
sf_team_invite SfTeamInviteType (sharing) Invited team members to shared folder (deprecated, replaced by 'Invited user to Dropbox and added them to shared file/folder')
SfTeamInviteType
description String
sf_team_invite_change_role SfTeamInviteChangeRoleType (sharing) Changed team member's role in shared folder (deprecated, no longer logged)
SfTeamInviteChangeRoleType
description String
sf_team_join SfTeamJoinType (sharing) Joined team member's shared folder (deprecated, no longer logged)
SfTeamJoinType
description String
sf_team_join_from_oob_link SfTeamJoinFromOobLinkType (sharing) Joined team member's shared folder from link (deprecated, no longer logged)
SfTeamJoinFromOobLinkType
description String
sf_team_uninvite SfTeamUninviteType (sharing) Unshared folder with team member (deprecated, replaced by 'Removed invitee from shared file/folder before invite was accepted')
SfTeamUninviteType
description String
shared_content_add_invitees SharedContentAddInviteesType (sharing) Invited user to Dropbox and added them to shared file/folder
SharedContentAddInviteesType
description String
shared_content_add_link_expiry SharedContentAddLinkExpiryType (sharing) Added expiration date to link for shared file/folder
SharedContentAddLinkExpiryType
description String
shared_content_add_link_password SharedContentAddLinkPasswordType (sharing) Added password to link for shared file/folder
SharedContentAddLinkPasswordType
description String
shared_content_add_member SharedContentAddMemberType (sharing) Added users and/or groups to shared file/folder
SharedContentAddMemberType
description String
shared_content_change_downloads_policy SharedContentChangeDownloadsPolicyType (sharing) Changed whether members can download shared file/folder
SharedContentChangeDownloadsPolicyType
description String
shared_content_change_invitee_role SharedContentChangeInviteeRoleType (sharing) Changed access type of invitee to shared file/folder before invite was accepted
SharedContentChangeInviteeRoleType
description String
shared_content_change_link_audience SharedContentChangeLinkAudienceType (sharing) Changed link audience of shared file/folder
SharedContentChangeLinkAudienceType
description String
shared_content_change_link_expiry SharedContentChangeLinkExpiryType (sharing) Changed link expiration of shared file/folder
SharedContentChangeLinkExpiryType
description String
shared_content_change_link_password SharedContentChangeLinkPasswordType (sharing) Changed link password of shared file/folder
SharedContentChangeLinkPasswordType
description String
shared_content_change_member_role SharedContentChangeMemberRoleType (sharing) Changed access type of shared file/folder member
SharedContentChangeMemberRoleType
description String
shared_content_change_viewer_info_policy SharedContentChangeViewerInfoPolicyType (sharing) Changed whether members can see who viewed shared file/folder
SharedContentChangeViewerInfoPolicyType
description String
shared_content_claim_invitation SharedContentClaimInvitationType (sharing) Acquired membership of shared file/folder by accepting invite
SharedContentClaimInvitationType
description String
shared_content_copy SharedContentCopyType (sharing) Copied shared file/folder to own Dropbox
SharedContentCopyType
description String
shared_content_download SharedContentDownloadType (sharing) Downloaded shared file/folder
SharedContentDownloadType
description String
shared_content_relinquish_membership SharedContentRelinquishMembershipType (sharing) Left shared file/folder
SharedContentRelinquishMembershipType
description String
shared_content_remove_invitees SharedContentRemoveInviteesType (sharing) Removed invitee from shared file/folder before invite was accepted
SharedContentRemoveInviteesType
description String
shared_content_remove_link_expiry SharedContentRemoveLinkExpiryType (sharing) Removed link expiration date of shared file/folder
SharedContentRemoveLinkExpiryType
description String
shared_content_remove_link_password SharedContentRemoveLinkPasswordType (sharing) Removed link password of shared file/folder
SharedContentRemoveLinkPasswordType
description String
shared_content_remove_member SharedContentRemoveMemberType (sharing) Removed user/group from shared file/folder
SharedContentRemoveMemberType
description String
shared_content_request_access SharedContentRequestAccessType (sharing) Requested access to shared file/folder
SharedContentRequestAccessType
description String
shared_content_unshare SharedContentUnshareType (sharing) Unshared file/folder by clearing membership and turning off link
SharedContentUnshareType
description String
shared_content_view SharedContentViewType (sharing) Previewed shared file/folder
SharedContentViewType
description String
shared_folder_change_link_policy SharedFolderChangeLinkPolicyType (sharing) Changed who can access shared folder via link
SharedFolderChangeLinkPolicyType
description String
shared_folder_change_members_inheritance_policy SharedFolderChangeMembersInheritancePolicyType (sharing) Changed whether shared folder inherits members from parent folder
SharedFolderChangeMembersInheritancePolicyType
description String
shared_folder_change_members_management_policy SharedFolderChangeMembersManagementPolicyType (sharing) Changed who can add/remove members of shared folder
SharedFolderChangeMembersManagementPolicyType
description String
shared_folder_change_members_policy SharedFolderChangeMembersPolicyType (sharing) Changed who can become member of shared folder
SharedFolderChangeMembersPolicyType
description String
shared_folder_create SharedFolderCreateType (sharing) Created shared folder
SharedFolderCreateType
description String
shared_folder_decline_invitation SharedFolderDeclineInvitationType (sharing) Declined team member's invite to shared folder
SharedFolderDeclineInvitationType
description String
shared_folder_mount SharedFolderMountType (sharing) Added shared folder to own Dropbox
SharedFolderMountType
description String
shared_folder_nest SharedFolderNestType (sharing) Changed parent of shared folder
SharedFolderNestType
description String
shared_folder_transfer_ownership SharedFolderTransferOwnershipType (sharing) Transferred ownership of shared folder to another member
SharedFolderTransferOwnershipType
description String
shared_folder_unmount SharedFolderUnmountType (sharing) Deleted shared folder from Dropbox
SharedFolderUnmountType
description String
shared_link_add_expiry SharedLinkAddExpiryType (sharing) Added shared link expiration date
SharedLinkAddExpiryType
description String
shared_link_change_expiry SharedLinkChangeExpiryType (sharing) Changed shared link expiration date
SharedLinkChangeExpiryType
description String
shared_link_change_visibility SharedLinkChangeVisibilityType (sharing) Changed visibility of shared link
SharedLinkChangeVisibilityType
description String
shared_link_copy SharedLinkCopyType (sharing) Added file/folder to Dropbox from shared link
SharedLinkCopyType
description String
shared_link_create SharedLinkCreateType (sharing) Created shared link
SharedLinkCreateType
description String
shared_link_disable SharedLinkDisableType (sharing) Removed shared link
SharedLinkDisableType
description String
shared_link_download SharedLinkDownloadType (sharing) Downloaded file/folder from shared link
SharedLinkDownloadType
description String
shared_link_remove_expiry SharedLinkRemoveExpiryType (sharing) Removed shared link expiration date
SharedLinkRemoveExpiryType
description String
shared_link_share SharedLinkShareType (sharing) Added members as audience of shared link
SharedLinkShareType
description String
shared_link_view SharedLinkViewType (sharing) Opened shared link
SharedLinkViewType
description String
shared_note_opened SharedNoteOpenedType (sharing) Opened shared Paper doc (deprecated, no longer logged)
SharedNoteOpenedType
description String
shmodel_group_share ShmodelGroupShareType (sharing) Shared link with group (deprecated, no longer logged)
ShmodelGroupShareType
description String
showcase_access_granted ShowcaseAccessGrantedType (showcase) Granted access to showcase
ShowcaseAccessGrantedType
description String
showcase_add_member ShowcaseAddMemberType (showcase) Added member to showcase
ShowcaseAddMemberType
description String
showcase_archived ShowcaseArchivedType (showcase) Archived showcase
ShowcaseArchivedType
description String
showcase_created ShowcaseCreatedType (showcase) Created showcase
ShowcaseCreatedType
description String
showcase_delete_comment ShowcaseDeleteCommentType (showcase) Deleted showcase comment
ShowcaseDeleteCommentType
description String
showcase_edited ShowcaseEditedType (showcase) Edited showcase
ShowcaseEditedType
description String
showcase_edit_comment ShowcaseEditCommentType (showcase) Edited showcase comment
ShowcaseEditCommentType
description String
showcase_file_added ShowcaseFileAddedType (showcase) Added file to showcase
ShowcaseFileAddedType
description String
showcase_file_download ShowcaseFileDownloadType (showcase) Downloaded file from showcase
ShowcaseFileDownloadType
description String
showcase_file_removed ShowcaseFileRemovedType (showcase) Removed file from showcase
ShowcaseFileRemovedType
description String
showcase_file_view ShowcaseFileViewType (showcase) Viewed file in showcase
ShowcaseFileViewType
description String
showcase_permanently_deleted ShowcasePermanentlyDeletedType (showcase) Permanently deleted showcase
ShowcasePermanentlyDeletedType
description String
showcase_post_comment ShowcasePostCommentType (showcase) Added showcase comment
ShowcasePostCommentType
description String
showcase_remove_member ShowcaseRemoveMemberType (showcase) Removed member from showcase
ShowcaseRemoveMemberType
description String
showcase_renamed ShowcaseRenamedType (showcase) Renamed showcase
ShowcaseRenamedType
description String
showcase_request_access ShowcaseRequestAccessType (showcase) Requested access to showcase
ShowcaseRequestAccessType
description String
showcase_resolve_comment ShowcaseResolveCommentType (showcase) Resolved showcase comment
ShowcaseResolveCommentType
description String
showcase_restored ShowcaseRestoredType (showcase) Unarchived showcase
ShowcaseRestoredType
description String
showcase_trashed ShowcaseTrashedType (showcase) Deleted showcase
ShowcaseTrashedType
description String
showcase_trashed_deprecated ShowcaseTrashedDeprecatedType (showcase) Deleted showcase (old version) (deprecated, replaced by 'Deleted showcase')
ShowcaseTrashedDeprecatedType
description String
showcase_unresolve_comment ShowcaseUnresolveCommentType (showcase) Unresolved showcase comment
ShowcaseUnresolveCommentType
description String
showcase_untrashed ShowcaseUntrashedType (showcase) Restored showcase
ShowcaseUntrashedType
description String
showcase_untrashed_deprecated ShowcaseUntrashedDeprecatedType (showcase) Restored showcase (old version) (deprecated, replaced by 'Restored showcase')
ShowcaseUntrashedDeprecatedType
description String
showcase_view ShowcaseViewType (showcase) Viewed showcase
ShowcaseViewType
description String
sso_add_cert SsoAddCertType (sso) Added X.509 certificate for SSO
SsoAddCertType
description String
sso_add_login_url SsoAddLoginUrlType (sso) Added sign-in URL for SSO
SsoAddLoginUrlType
description String
sso_add_logout_url SsoAddLogoutUrlType (sso) Added sign-out URL for SSO
SsoAddLogoutUrlType
description String
sso_change_cert SsoChangeCertType (sso) Changed X.509 certificate for SSO
SsoChangeCertType
description String
sso_change_login_url SsoChangeLoginUrlType (sso) Changed sign-in URL for SSO
SsoChangeLoginUrlType
description String
sso_change_logout_url SsoChangeLogoutUrlType (sso) Changed sign-out URL for SSO
SsoChangeLogoutUrlType
description String
sso_change_saml_identity_mode SsoChangeSamlIdentityModeType (sso) Changed SAML identity mode for SSO
SsoChangeSamlIdentityModeType
description String
sso_remove_cert SsoRemoveCertType (sso) Removed X.509 certificate for SSO
SsoRemoveCertType
description String
sso_remove_login_url SsoRemoveLoginUrlType (sso) Removed sign-in URL for SSO
SsoRemoveLoginUrlType
description String
sso_remove_logout_url SsoRemoveLogoutUrlType (sso) Removed sign-out URL for SSO
SsoRemoveLogoutUrlType
description String
team_folder_change_status TeamFolderChangeStatusType (team_folders) Changed archival status of team folder
TeamFolderChangeStatusType
description String
team_folder_create TeamFolderCreateType (team_folders) Created team folder in active status
TeamFolderCreateType
description String
team_folder_downgrade TeamFolderDowngradeType (team_folders) Downgraded team folder to regular shared folder
TeamFolderDowngradeType
description String
team_folder_permanently_delete TeamFolderPermanentlyDeleteType (team_folders) Permanently deleted archived team folder
TeamFolderPermanentlyDeleteType
description String
team_folder_rename TeamFolderRenameType (team_folders) Renamed active/archived team folder
TeamFolderRenameType
description String
team_selective_sync_settings_changed TeamSelectiveSyncSettingsChangedType (team_folders) Changed sync default
TeamSelectiveSyncSettingsChangedType
description String
account_capture_change_policy AccountCaptureChangePolicyType (team_policies) Changed account capture setting on team domain
AccountCaptureChangePolicyType
description String
allow_download_disabled AllowDownloadDisabledType (team_policies) Disabled downloads (deprecated, no longer logged)
AllowDownloadDisabledType
description String
allow_download_enabled AllowDownloadEnabledType (team_policies) Enabled downloads (deprecated, no longer logged)
AllowDownloadEnabledType
description String
data_placement_restriction_change_policy DataPlacementRestrictionChangePolicyType (team_policies) Set restrictions on data center locations where team data resides
DataPlacementRestrictionChangePolicyType
description String
data_placement_restriction_satisfy_policy DataPlacementRestrictionSatisfyPolicyType (team_policies) Completed restrictions on data center locations where team data resides
DataPlacementRestrictionSatisfyPolicyType
description String
device_approvals_change_desktop_policy DeviceApprovalsChangeDesktopPolicyType (team_policies) Set/removed limit on number of computers member can link to team Dropbox account
DeviceApprovalsChangeDesktopPolicyType
description String
device_approvals_change_mobile_policy DeviceApprovalsChangeMobilePolicyType (team_policies) Set/removed limit on number of mobile devices member can link to team Dropbox account
DeviceApprovalsChangeMobilePolicyType
description String
device_approvals_change_overage_action DeviceApprovalsChangeOverageActionType (team_policies) Changed device approvals setting when member is over limit
DeviceApprovalsChangeOverageActionType
description String
device_approvals_change_unlink_action DeviceApprovalsChangeUnlinkActionType (team_policies) Changed device approvals setting when member unlinks approved device
DeviceApprovalsChangeUnlinkActionType
description String
directory_restrictions_add_members DirectoryRestrictionsAddMembersType (team_policies) Added members to directory restrictions list
DirectoryRestrictionsAddMembersType
description String
directory_restrictions_remove_members DirectoryRestrictionsRemoveMembersType (team_policies) Removed members from directory restrictions list
DirectoryRestrictionsRemoveMembersType
description String
emm_add_exception EmmAddExceptionType (team_policies) Added members to EMM exception list
EmmAddExceptionType
description String
emm_change_policy EmmChangePolicyType (team_policies) Enabled/disabled enterprise mobility management for members
EmmChangePolicyType
description String
emm_remove_exception EmmRemoveExceptionType (team_policies) Removed members from EMM exception list
EmmRemoveExceptionType
description String
extended_version_history_change_policy ExtendedVersionHistoryChangePolicyType (team_policies) Accepted/opted out of extended version history
ExtendedVersionHistoryChangePolicyType
description String
file_comments_change_policy FileCommentsChangePolicyType (team_policies) Enabled/disabled commenting on team files
FileCommentsChangePolicyType
description String
file_requests_change_policy FileRequestsChangePolicyType (team_policies) Enabled/disabled file requests
FileRequestsChangePolicyType
description String
file_requests_emails_enabled FileRequestsEmailsEnabledType (team_policies) Enabled file request emails for everyone (deprecated, no longer logged)
FileRequestsEmailsEnabledType
description String
file_requests_emails_restricted_to_team_only FileRequestsEmailsRestrictedToTeamOnlyType (team_policies) Enabled file request emails for team (deprecated, no longer logged)
FileRequestsEmailsRestrictedToTeamOnlyType
description String
google_sso_change_policy GoogleSsoChangePolicyType (team_policies) Enabled/disabled Google single sign-on for team
GoogleSsoChangePolicyType
description String
group_user_management_change_policy GroupUserManagementChangePolicyType (team_policies) Changed who can create groups
GroupUserManagementChangePolicyType
description String
member_requests_change_policy MemberRequestsChangePolicyType (team_policies) Changed whether users can find team when not invited
MemberRequestsChangePolicyType
description String
member_space_limits_add_exception MemberSpaceLimitsAddExceptionType (team_policies) Added members to member space limit exception list
MemberSpaceLimitsAddExceptionType
description String
member_space_limits_change_caps_type_policy MemberSpaceLimitsChangeCapsTypePolicyType (team_policies) Changed member space limit type for team
MemberSpaceLimitsChangeCapsTypePolicyType
description String
member_space_limits_change_policy MemberSpaceLimitsChangePolicyType (team_policies) Changed team default member space limit
MemberSpaceLimitsChangePolicyType
description String
member_space_limits_remove_exception MemberSpaceLimitsRemoveExceptionType (team_policies) Removed members from member space limit exception list
MemberSpaceLimitsRemoveExceptionType
description String
member_suggestions_change_policy MemberSuggestionsChangePolicyType (team_policies) Enabled/disabled option for team members to suggest people to add to team
MemberSuggestionsChangePolicyType
description String
microsoft_office_addin_change_policy MicrosoftOfficeAddinChangePolicyType (team_policies) Enabled/disabled Microsoft Office add-in
MicrosoftOfficeAddinChangePolicyType
description String
network_control_change_policy NetworkControlChangePolicyType (team_policies) Enabled/disabled network control
NetworkControlChangePolicyType
description String
paper_change_deployment_policy PaperChangeDeploymentPolicyType (team_policies) Changed whether Dropbox Paper, when enabled, is deployed to all members or to specific members
PaperChangeDeploymentPolicyType
description String
paper_change_member_link_policy PaperChangeMemberLinkPolicyType (team_policies) Changed whether non-members can view Paper docs with link (deprecated, no longer logged)
PaperChangeMemberLinkPolicyType
description String
paper_change_member_policy PaperChangeMemberPolicyType (team_policies) Changed whether members can share Paper docs outside team, and if docs are accessible only by team members or anyone by default
PaperChangeMemberPolicyType
description String
paper_change_policy PaperChangePolicyType (team_policies) Enabled/disabled Dropbox Paper for team
PaperChangePolicyType
description String
paper_enabled_users_group_addition PaperEnabledUsersGroupAdditionType (team_policies) Added users to Paper-enabled users list
PaperEnabledUsersGroupAdditionType
description String
paper_enabled_users_group_removal PaperEnabledUsersGroupRemovalType (team_policies) Removed users from Paper-enabled users list
PaperEnabledUsersGroupRemovalType
description String
permanent_delete_change_policy PermanentDeleteChangePolicyType (team_policies) Enabled/disabled ability of team members to permanently delete content
PermanentDeleteChangePolicyType
description String
sharing_change_folder_join_policy SharingChangeFolderJoinPolicyType (team_policies) Changed whether team members can join shared folders owned outside team
SharingChangeFolderJoinPolicyType
description String
sharing_change_link_policy SharingChangeLinkPolicyType (team_policies) Changed whether members can share links outside team, and if links are accessible only by team members or anyone by default
SharingChangeLinkPolicyType
description String
sharing_change_member_policy SharingChangeMemberPolicyType (team_policies) Changed whether members can share files/folders outside team
SharingChangeMemberPolicyType
description String
showcase_change_download_policy ShowcaseChangeDownloadPolicyType (team_policies) Enabled/disabled downloading files from Dropbox Showcase for team
ShowcaseChangeDownloadPolicyType
description String
showcase_change_enabled_policy ShowcaseChangeEnabledPolicyType (team_policies) Enabled/disabled Dropbox Showcase for team
ShowcaseChangeEnabledPolicyType
description String
showcase_change_external_sharing_policy ShowcaseChangeExternalSharingPolicyType (team_policies) Enabled/disabled sharing Dropbox Showcase externally for team
ShowcaseChangeExternalSharingPolicyType
description String
smart_sync_change_policy SmartSyncChangePolicyType (team_policies) Changed default Smart Sync setting for team members
SmartSyncChangePolicyType
description String
smart_sync_not_opt_out SmartSyncNotOptOutType (team_policies) Opted team into Smart Sync
SmartSyncNotOptOutType
description String
smart_sync_opt_out SmartSyncOptOutType (team_policies) Opted team out of Smart Sync
SmartSyncOptOutType
description String
sso_change_policy SsoChangePolicyType (team_policies) Changed single sign-on setting for team
SsoChangePolicyType
description String
team_selective_sync_policy_changed TeamSelectiveSyncPolicyChangedType (team_policies) Enabled/disabled Team Selective Sync for team
TeamSelectiveSyncPolicyChangedType
description String
tfa_change_policy TfaChangePolicyType (team_policies) Changed two-step verification setting for team
TfaChangePolicyType
description String
two_account_change_policy TwoAccountChangePolicyType (team_policies) Enabled/disabled option for members to link personal Dropbox account and team account to same computer
TwoAccountChangePolicyType
description String
viewer_info_policy_changed ViewerInfoPolicyChangedType (team_policies) Changed team policy for viewer info
ViewerInfoPolicyChangedType
description String
web_sessions_change_fixed_length_policy WebSessionsChangeFixedLengthPolicyType (team_policies) Changed how long members can stay signed in to Dropbox.com
WebSessionsChangeFixedLengthPolicyType
description String
web_sessions_change_idle_length_policy WebSessionsChangeIdleLengthPolicyType (team_policies) Changed how long team members can be idle while signed in to Dropbox.com
WebSessionsChangeIdleLengthPolicyType
description String
team_merge_from TeamMergeFromType (team_profile) Merged another team into this team
TeamMergeFromType
description String
team_merge_to TeamMergeToType (team_profile) Merged this team into another team
TeamMergeToType
description String
team_profile_add_logo TeamProfileAddLogoType (team_profile) Added team logo to display on shared link headers
TeamProfileAddLogoType
description String
team_profile_change_default_language TeamProfileChangeDefaultLanguageType (team_profile) Changed default language for team
TeamProfileChangeDefaultLanguageType
description String
team_profile_change_logo TeamProfileChangeLogoType (team_profile) Changed team logo displayed on shared link headers
TeamProfileChangeLogoType
description String
team_profile_change_name TeamProfileChangeNameType (team_profile) Changed team name
TeamProfileChangeNameType
description String
team_profile_remove_logo TeamProfileRemoveLogoType (team_profile) Removed team logo displayed on shared link headers
TeamProfileRemoveLogoType
description String
tfa_add_backup_phone TfaAddBackupPhoneType (tfa) Added backup phone for two-step verification
TfaAddBackupPhoneType
description String
tfa_add_security_key TfaAddSecurityKeyType (tfa) Added security key for two-step verification
TfaAddSecurityKeyType
description String
tfa_change_backup_phone TfaChangeBackupPhoneType (tfa) Changed backup phone for two-step verification
TfaChangeBackupPhoneType
description String
tfa_change_status TfaChangeStatusType (tfa) Enabled/disabled/changed two-step verification setting
TfaChangeStatusType
description String
tfa_remove_backup_phone TfaRemoveBackupPhoneType (tfa) Removed backup phone for two-step verification
TfaRemoveBackupPhoneType
description String
tfa_remove_security_key TfaRemoveSecurityKeyType (tfa) Removed security key for two-step verification
TfaRemoveSecurityKeyType
description String
tfa_reset TfaResetType (tfa) Reset two-step verification for team member
TfaResetType
description String
details EventDetails The variable event schema applicable to this type of action, instantiated with respect to this particular action.
EventDetails (open union)
Additional fields depending on the event type. The value will be one of the following datatypes. New values may be introduced as our API evolves.
app_link_team_details AppLinkTeamDetails
AppLinkTeamDetails
Linked app for team.
app_info AppLogInfo Relevant application details.
AppLogInfo (datatype with subtypes)
App's logged information. This datatype will be one of the following subtypes:
user_or_team_linked_app UserOrTeamLinkedAppLogInfo
UserOrTeamLinkedAppLogInfo
User or team linked app. Used when linked type is missing due to historical data gap.
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
user_linked_app UserLinkedAppLogInfo
UserLinkedAppLogInfo
User linked app
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
team_linked_app TeamLinkedAppLogInfo
TeamLinkedAppLogInfo
Team linked app
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
app_link_user_details AppLinkUserDetails
AppLinkUserDetails
Linked app for member.
app_info AppLogInfo Relevant application details.
AppLogInfo (datatype with subtypes)
App's logged information. This datatype will be one of the following subtypes:
user_or_team_linked_app UserOrTeamLinkedAppLogInfo
UserOrTeamLinkedAppLogInfo
User or team linked app. Used when linked type is missing due to historical data gap.
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
user_linked_app UserLinkedAppLogInfo
UserLinkedAppLogInfo
User linked app
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
team_linked_app TeamLinkedAppLogInfo
TeamLinkedAppLogInfo
Team linked app
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
app_unlink_team_details AppUnlinkTeamDetails
AppUnlinkTeamDetails
Unlinked app for team.
app_info AppLogInfo Relevant application details.
AppLogInfo (datatype with subtypes)
App's logged information. This datatype will be one of the following subtypes:
user_or_team_linked_app UserOrTeamLinkedAppLogInfo
UserOrTeamLinkedAppLogInfo
User or team linked app. Used when linked type is missing due to historical data gap.
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
user_linked_app UserLinkedAppLogInfo
UserLinkedAppLogInfo
User linked app
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
team_linked_app TeamLinkedAppLogInfo
TeamLinkedAppLogInfo
Team linked app
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
app_unlink_user_details AppUnlinkUserDetails
AppUnlinkUserDetails
Unlinked app for member.
app_info AppLogInfo Relevant application details.
AppLogInfo (datatype with subtypes)
App's logged information. This datatype will be one of the following subtypes:
user_or_team_linked_app UserOrTeamLinkedAppLogInfo
UserOrTeamLinkedAppLogInfo
User or team linked app. Used when linked type is missing due to historical data gap.
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
user_linked_app UserLinkedAppLogInfo
UserLinkedAppLogInfo
User linked app
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
team_linked_app TeamLinkedAppLogInfo
TeamLinkedAppLogInfo
Team linked app
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
file_add_comment_details FileAddCommentDetails
FileAddCommentDetails
Added file comment.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
file_change_comment_subscription_details FileChangeCommentSubscriptionDetails
FileChangeCommentSubscriptionDetails
Subscribed to or unsubscribed from comment notifications for file.
new_value FileCommentNotificationPolicy New file comment subscription.
FileCommentNotificationPolicy (open union)
Enable or disable file comments notifications The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
previous_value FileCommentNotificationPolicy? Previous file comment subscription. Might be missing due to historical data gap. This field is optional.
FileCommentNotificationPolicy (open union)
Enable or disable file comments notifications The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
file_delete_comment_details FileDeleteCommentDetails
FileDeleteCommentDetails
Deleted file comment.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
file_like_comment_details FileLikeCommentDetails
FileLikeCommentDetails
Liked file comment.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
file_resolve_comment_details FileResolveCommentDetails
FileResolveCommentDetails
Resolved file comment.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
file_unlike_comment_details FileUnlikeCommentDetails
FileUnlikeCommentDetails
Unliked file comment.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
file_unresolve_comment_details FileUnresolveCommentDetails
FileUnresolveCommentDetails
Unresolved file comment.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
device_change_ip_desktop_details DeviceChangeIpDesktopDetails
DeviceChangeIpDesktopDetails
Changed IP address associated with active desktop session.
device_session_info DeviceSessionLogInfo Device's session logged information.
DeviceSessionLogInfo (datatype with subtypes)
Device's session logged information. This datatype will be one of the following subtypes:
desktop_device_session DesktopDeviceSessionLogInfo
DesktopDeviceSessionLogInfo
Information about linked Dropbox desktop client sessions
host_name String Name of the hosting desktop.
client_type DesktopPlatform The Dropbox desktop client type.
DesktopPlatform (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
windows Void Official Windows Dropbox desktop client.
mac Void Official Mac Dropbox desktop client.
linux Void Official Linux Dropbox desktop client.
platform String Information on the hosting platform.
is_delete_on_unlink_supported Boolean Whether itu2019s possible to delete all of the account files upon unlinking.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info DesktopSessionLogInfo? Desktop session unique id. Might be missing due to historical data gap. This field is optional.
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. This field is optional.
mobile_device_session MobileDeviceSessionLogInfo
MobileDeviceSessionLogInfo
Information about linked Dropbox mobile client sessions
device_name String The device name.
client_type MobileClientPlatform The mobile application type.
MobileClientPlatform (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
iphone Void Official Dropbox iPhone client.
ipad Void Official Dropbox iPad client.
android Void Official Dropbox Android client.
windows_phone Void Official Dropbox Windows phone client.
blackberry Void Official Dropbox Blackberry client.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info MobileSessionLogInfo? Mobile session unique id. Might be missing due to historical data gap. This field is optional.
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. This field is optional.
os_version String? The hosting OS version. This field is optional.
last_carrier String? last carrier used by the device. This field is optional.
web_device_session WebDeviceSessionLogInfo
WebDeviceSessionLogInfo
Information on active web sessions
user_agent String Information on the hosting device.
os String Information on the hosting operating system.
browser String Information on the browser used for this web session.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info WebSessionLogInfo? Web session unique id. Might be missing due to historical data gap. This field is optional.
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
legacy_device_session LegacyDeviceSessionLogInfo
LegacyDeviceSessionLogInfo
Information on sessions, in legacy format
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info SessionLogInfo? Session unique id. Might be missing due to historical data gap. This field is optional.
SessionLogInfo (datatype with subtypes)
Session's logged information. This datatype will be one of the following subtypes:
web WebSessionLogInfo
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
desktop DesktopSessionLogInfo
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
mobile MobileSessionLogInfo
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
display_name String? The device name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? Is device managed by emm. Might be missing due to historical data gap. This field is optional.
platform String? Information on the hosting platform. Might be missing due to historical data gap. This field is optional.
mac_address String? The mac address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
os_version String? The hosting OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Information on the hosting device type. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. Might be missing due to historical data gap. This field is optional.
legacy_uniq_id String? Alternative unique device session id, instead of session id field. Might be missing due to historical data gap. This field is optional.
device_change_ip_mobile_details DeviceChangeIpMobileDetails
DeviceChangeIpMobileDetails
Changed IP address associated with active mobile session.
device_session_info DeviceSessionLogInfo? Device's session logged information. This field is optional.
DeviceSessionLogInfo (datatype with subtypes)
Device's session logged information. This datatype will be one of the following subtypes:
desktop_device_session DesktopDeviceSessionLogInfo
DesktopDeviceSessionLogInfo
Information about linked Dropbox desktop client sessions
host_name String Name of the hosting desktop.
client_type DesktopPlatform The Dropbox desktop client type.
DesktopPlatform (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
windows Void Official Windows Dropbox desktop client.
mac Void Official Mac Dropbox desktop client.
linux Void Official Linux Dropbox desktop client.
platform String Information on the hosting platform.
is_delete_on_unlink_supported Boolean Whether itu2019s possible to delete all of the account files upon unlinking.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info DesktopSessionLogInfo? Desktop session unique id. Might be missing due to historical data gap. This field is optional.
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. This field is optional.
mobile_device_session MobileDeviceSessionLogInfo
MobileDeviceSessionLogInfo
Information about linked Dropbox mobile client sessions
device_name String The device name.
client_type MobileClientPlatform The mobile application type.
MobileClientPlatform (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
iphone Void Official Dropbox iPhone client.
ipad Void Official Dropbox iPad client.
android Void Official Dropbox Android client.
windows_phone Void Official Dropbox Windows phone client.
blackberry Void Official Dropbox Blackberry client.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info MobileSessionLogInfo? Mobile session unique id. Might be missing due to historical data gap. This field is optional.
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. This field is optional.
os_version String? The hosting OS version. This field is optional.
last_carrier String? last carrier used by the device. This field is optional.
web_device_session WebDeviceSessionLogInfo
WebDeviceSessionLogInfo
Information on active web sessions
user_agent String Information on the hosting device.
os String Information on the hosting operating system.
browser String Information on the browser used for this web session.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info WebSessionLogInfo? Web session unique id. Might be missing due to historical data gap. This field is optional.
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
legacy_device_session LegacyDeviceSessionLogInfo
LegacyDeviceSessionLogInfo
Information on sessions, in legacy format
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info SessionLogInfo? Session unique id. Might be missing due to historical data gap. This field is optional.
SessionLogInfo (datatype with subtypes)
Session's logged information. This datatype will be one of the following subtypes:
web WebSessionLogInfo
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
desktop DesktopSessionLogInfo
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
mobile MobileSessionLogInfo
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
display_name String? The device name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? Is device managed by emm. Might be missing due to historical data gap. This field is optional.
platform String? Information on the hosting platform. Might be missing due to historical data gap. This field is optional.
mac_address String? The mac address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
os_version String? The hosting OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Information on the hosting device type. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. Might be missing due to historical data gap. This field is optional.
legacy_uniq_id String? Alternative unique device session id, instead of session id field. Might be missing due to historical data gap. This field is optional.
device_change_ip_web_details DeviceChangeIpWebDetails
DeviceChangeIpWebDetails
Changed IP address associated with active web session.
user_agent String Web browser name.
device_delete_on_unlink_fail_details DeviceDeleteOnUnlinkFailDetails
DeviceDeleteOnUnlinkFailDetails
Failed to delete all files from unlinked device.
num_failures Int64 The number of times that remote file deletion failed.
session_info SessionLogInfo? Session unique id. Might be missing due to historical data gap. This field is optional.
SessionLogInfo (datatype with subtypes)
Session's logged information. This datatype will be one of the following subtypes:
web WebSessionLogInfo
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
desktop DesktopSessionLogInfo
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
mobile MobileSessionLogInfo
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
display_name String? The device name. Might be missing due to historical data gap. This field is optional.
device_delete_on_unlink_success_details DeviceDeleteOnUnlinkSuccessDetails
DeviceDeleteOnUnlinkSuccessDetails
Deleted all files from unlinked device.
session_info SessionLogInfo? Session unique id. Might be missing due to historical data gap. This field is optional.
SessionLogInfo (datatype with subtypes)
Session's logged information. This datatype will be one of the following subtypes:
web WebSessionLogInfo
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
desktop DesktopSessionLogInfo
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
mobile MobileSessionLogInfo
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
display_name String? The device name. Might be missing due to historical data gap. This field is optional.
device_link_fail_details DeviceLinkFailDetails
DeviceLinkFailDetails
Failed to link device.
device_type DeviceType A description of the device used while user approval blocked.
DeviceType (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
desktop Void
mobile Void
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
device_link_success_details DeviceLinkSuccessDetails
DeviceLinkSuccessDetails
Linked device.
device_session_info DeviceSessionLogInfo? Device's session logged information. This field is optional.
DeviceSessionLogInfo (datatype with subtypes)
Device's session logged information. This datatype will be one of the following subtypes:
desktop_device_session DesktopDeviceSessionLogInfo
DesktopDeviceSessionLogInfo
Information about linked Dropbox desktop client sessions
host_name String Name of the hosting desktop.
client_type DesktopPlatform The Dropbox desktop client type.
DesktopPlatform (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
windows Void Official Windows Dropbox desktop client.
mac Void Official Mac Dropbox desktop client.
linux Void Official Linux Dropbox desktop client.
platform String Information on the hosting platform.
is_delete_on_unlink_supported Boolean Whether itu2019s possible to delete all of the account files upon unlinking.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info DesktopSessionLogInfo? Desktop session unique id. Might be missing due to historical data gap. This field is optional.
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. This field is optional.
mobile_device_session MobileDeviceSessionLogInfo
MobileDeviceSessionLogInfo
Information about linked Dropbox mobile client sessions
device_name String The device name.
client_type MobileClientPlatform The mobile application type.
MobileClientPlatform (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
iphone Void Official Dropbox iPhone client.
ipad Void Official Dropbox iPad client.
android Void Official Dropbox Android client.
windows_phone Void Official Dropbox Windows phone client.
blackberry Void Official Dropbox Blackberry client.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info MobileSessionLogInfo? Mobile session unique id. Might be missing due to historical data gap. This field is optional.
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. This field is optional.
os_version String? The hosting OS version. This field is optional.
last_carrier String? last carrier used by the device. This field is optional.
web_device_session WebDeviceSessionLogInfo
WebDeviceSessionLogInfo
Information on active web sessions
user_agent String Information on the hosting device.
os String Information on the hosting operating system.
browser String Information on the browser used for this web session.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info WebSessionLogInfo? Web session unique id. Might be missing due to historical data gap. This field is optional.
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
legacy_device_session LegacyDeviceSessionLogInfo
LegacyDeviceSessionLogInfo
Information on sessions, in legacy format
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info SessionLogInfo? Session unique id. Might be missing due to historical data gap. This field is optional.
SessionLogInfo (datatype with subtypes)
Session's logged information. This datatype will be one of the following subtypes:
web WebSessionLogInfo
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
desktop DesktopSessionLogInfo
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
mobile MobileSessionLogInfo
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
display_name String? The device name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? Is device managed by emm. Might be missing due to historical data gap. This field is optional.
platform String? Information on the hosting platform. Might be missing due to historical data gap. This field is optional.
mac_address String? The mac address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
os_version String? The hosting OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Information on the hosting device type. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. Might be missing due to historical data gap. This field is optional.
legacy_uniq_id String? Alternative unique device session id, instead of session id field. Might be missing due to historical data gap. This field is optional.
device_management_disabled_details DeviceManagementDisabledDetails
DeviceManagementDisabledDetails
Disabled device management.
device_management_enabled_details DeviceManagementEnabledDetails
DeviceManagementEnabledDetails
Enabled device management.
device_unlink_details DeviceUnlinkDetails
DeviceUnlinkDetails
Disconnected device.
delete_data Boolean True if the user requested to delete data after device unlink, false otherwise.
session_info SessionLogInfo? Session unique id. This field is optional.
SessionLogInfo (datatype with subtypes)
Session's logged information. This datatype will be one of the following subtypes:
web WebSessionLogInfo
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
desktop DesktopSessionLogInfo
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
mobile MobileSessionLogInfo
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
display_name String? The device name. Might be missing due to historical data gap. This field is optional.
emm_refresh_auth_token_details EmmRefreshAuthTokenDetails
EmmRefreshAuthTokenDetails
Refreshed auth token used for setting up enterprise mobility management.
account_capture_change_availability_details AccountCaptureChangeAvailabilityDetails
AccountCaptureChangeAvailabilityDetails
Granted/revoked option to enable account capture on team domains.
new_value AccountCaptureAvailability New account capture availabilty value.
AccountCaptureAvailability (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
unavailable Void
available Void
previous_value AccountCaptureAvailability? Previous account capture availabilty value. Might be missing due to historical data gap. This field is optional.
AccountCaptureAvailability (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
unavailable Void
available Void
account_capture_migrate_account_details AccountCaptureMigrateAccountDetails
AccountCaptureMigrateAccountDetails
Account-captured user migrated account to team.
domain_name String Domain name.
account_capture_notification_emails_sent_details AccountCaptureNotificationEmailsSentDetails
AccountCaptureNotificationEmailsSentDetails
Sent proactive account capture email to all unmanaged members.
domain_name String Domain name.
account_capture_relinquish_account_details AccountCaptureRelinquishAccountDetails
AccountCaptureRelinquishAccountDetails
Account-captured user changed account email to personal email.
domain_name String Domain name.
disabled_domain_invites_details DisabledDomainInvitesDetails
DisabledDomainInvitesDetails
Disabled domain invites.
domain_invites_approve_request_to_join_team_details DomainInvitesApproveRequestToJoinTeamDetails
DomainInvitesApproveRequestToJoinTeamDetails
Approved user's request to join team.
domain_invites_decline_request_to_join_team_details DomainInvitesDeclineRequestToJoinTeamDetails
DomainInvitesDeclineRequestToJoinTeamDetails
Declined user's request to join team.
domain_invites_email_existing_users_details DomainInvitesEmailExistingUsersDetails
DomainInvitesEmailExistingUsersDetails
Sent domain invites to existing domain accounts.
domain_name String Domain names.
num_recipients UInt64 Number of recipients.
domain_invites_request_to_join_team_details DomainInvitesRequestToJoinTeamDetails
DomainInvitesRequestToJoinTeamDetails
Requested to join team.
domain_invites_set_invite_new_user_pref_to_no_details DomainInvitesSetInviteNewUserPrefToNoDetails
DomainInvitesSetInviteNewUserPrefToNoDetails
Disabled "Automatically invite new users".
domain_invites_set_invite_new_user_pref_to_yes_details DomainInvitesSetInviteNewUserPrefToYesDetails
DomainInvitesSetInviteNewUserPrefToYesDetails
Enabled "Automatically invite new users".
domain_verification_add_domain_fail_details DomainVerificationAddDomainFailDetails
DomainVerificationAddDomainFailDetails
Failed to verify team domain.
domain_name String Domain name.
verification_method String? Domain name verification method. Might be missing due to historical data gap. This field is optional.
domain_verification_add_domain_success_details DomainVerificationAddDomainSuccessDetails
DomainVerificationAddDomainSuccessDetails
Verified team domain.
domain_names List of (String) Domain names.
verification_method String? Domain name verification method. Might be missing due to historical data gap. This field is optional.
domain_verification_remove_domain_details DomainVerificationRemoveDomainDetails
DomainVerificationRemoveDomainDetails
Removed domain from list of verified team domains.
domain_names List of (String) Domain names.
enabled_domain_invites_details EnabledDomainInvitesDetails
EnabledDomainInvitesDetails
Enabled domain invites.
create_folder_details CreateFolderDetails
CreateFolderDetails
Created folders.
file_add_details FileAddDetails
FileAddDetails
Added files and/or folders.
file_copy_details FileCopyDetails
FileCopyDetails
Copied files and/or folders.
relocate_action_details List of (RelocateAssetReferencesLogInfo) Relocate action details.
RelocateAssetReferencesLogInfo
Provides the indices of the source asset and the destination asset for a relocate action.
src_asset_index UInt64 Source asset position in the Assets list.
dest_asset_index UInt64 Destination asset position in the Assets list.
file_delete_details FileDeleteDetails
FileDeleteDetails
Deleted files and/or folders.
file_download_details FileDownloadDetails
FileDownloadDetails
Downloaded files and/or folders.
file_edit_details FileEditDetails
FileEditDetails
Edited files.
file_get_copy_reference_details FileGetCopyReferenceDetails
FileGetCopyReferenceDetails
Created copy reference to file/folder.
file_move_details FileMoveDetails
FileMoveDetails
Moved files and/or folders.
relocate_action_details List of (RelocateAssetReferencesLogInfo) Relocate action details.
RelocateAssetReferencesLogInfo
Provides the indices of the source asset and the destination asset for a relocate action.
src_asset_index UInt64 Source asset position in the Assets list.
dest_asset_index UInt64 Destination asset position in the Assets list.
file_permanently_delete_details FilePermanentlyDeleteDetails
FilePermanentlyDeleteDetails
Permanently deleted files and/or folders.
file_preview_details FilePreviewDetails
FilePreviewDetails
Previewed files and/or folders.
file_rename_details FileRenameDetails
FileRenameDetails
Renamed files and/or folders.
relocate_action_details List of (RelocateAssetReferencesLogInfo) Relocate action details.
RelocateAssetReferencesLogInfo
Provides the indices of the source asset and the destination asset for a relocate action.
src_asset_index UInt64 Source asset position in the Assets list.
dest_asset_index UInt64 Destination asset position in the Assets list.
file_restore_details FileRestoreDetails
FileRestoreDetails
Restored deleted files and/or folders.
file_revert_details FileRevertDetails
FileRevertDetails
Reverted files to previous version.
file_rollback_changes_details FileRollbackChangesDetails
FileRollbackChangesDetails
Rolled back file actions.
file_save_copy_reference_details FileSaveCopyReferenceDetails
FileSaveCopyReferenceDetails
Saved file/folder using copy reference.
relocate_action_details List of (RelocateAssetReferencesLogInfo) Relocate action details.
RelocateAssetReferencesLogInfo
Provides the indices of the source asset and the destination asset for a relocate action.
src_asset_index UInt64 Source asset position in the Assets list.
dest_asset_index UInt64 Destination asset position in the Assets list.
file_request_change_details FileRequestChangeDetails
FileRequestChangeDetails
Changed file request.
new_details FileRequestDetails New file request details.
FileRequestDetails
File request details
asset_index UInt64 Asset position in the Assets list.
deadline FileRequestDeadline? File request deadline. Might be missing due to historical data gap. This field is optional.
FileRequestDeadline
File request deadline
deadline Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The deadline for this file request. Might be missing due to historical data gap. This field is optional.
allow_late_uploads String? If set, allow uploads after the deadline has passed. Might be missing due to historical data gap. This field is optional.
file_request_id String(min_length=1, pattern="[-_0-9a-zA-Z]+")? File request id. Might be missing due to historical data gap. This field is optional.
previous_details FileRequestDetails? Previous file request details. Might be missing due to historical data gap. This field is optional.
FileRequestDetails
File request details
asset_index UInt64 Asset position in the Assets list.
deadline FileRequestDeadline? File request deadline. Might be missing due to historical data gap. This field is optional.
FileRequestDeadline
File request deadline
deadline Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The deadline for this file request. Might be missing due to historical data gap. This field is optional.
allow_late_uploads String? If set, allow uploads after the deadline has passed. Might be missing due to historical data gap. This field is optional.
file_request_close_details FileRequestCloseDetails
FileRequestCloseDetails
Closed file request.
file_request_id String(min_length=1, pattern="[-_0-9a-zA-Z]+")? File request id. Might be missing due to historical data gap. This field is optional.
previous_details FileRequestDetails? Previous file request details. Might be missing due to historical data gap. This field is optional.
FileRequestDetails
File request details
asset_index UInt64 Asset position in the Assets list.
deadline FileRequestDeadline? File request deadline. Might be missing due to historical data gap. This field is optional.
FileRequestDeadline
File request deadline
deadline Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The deadline for this file request. Might be missing due to historical data gap. This field is optional.
allow_late_uploads String? If set, allow uploads after the deadline has passed. Might be missing due to historical data gap. This field is optional.
file_request_create_details FileRequestCreateDetails
FileRequestCreateDetails
Created file request.
file_request_id String(min_length=1, pattern="[-_0-9a-zA-Z]+")? File request id. Might be missing due to historical data gap. This field is optional.
request_details FileRequestDetails? File request details. Might be missing due to historical data gap. This field is optional.
FileRequestDetails
File request details
asset_index UInt64 Asset position in the Assets list.
deadline FileRequestDeadline? File request deadline. Might be missing due to historical data gap. This field is optional.
FileRequestDeadline
File request deadline
deadline Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The deadline for this file request. Might be missing due to historical data gap. This field is optional.
allow_late_uploads String? If set, allow uploads after the deadline has passed. Might be missing due to historical data gap. This field is optional.
file_request_receive_file_details FileRequestReceiveFileDetails
FileRequestReceiveFileDetails
Received files for file request.
submitted_file_names List of (String) Submitted file names.
file_request_id String(min_length=1, pattern="[-_0-9a-zA-Z]+")? File request id. Might be missing due to historical data gap. This field is optional.
file_request_details FileRequestDetails? File request details. Might be missing due to historical data gap. This field is optional.
FileRequestDetails
File request details
asset_index UInt64 Asset position in the Assets list.
deadline FileRequestDeadline? File request deadline. Might be missing due to historical data gap. This field is optional.
FileRequestDeadline
File request deadline
deadline Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The deadline for this file request. Might be missing due to historical data gap. This field is optional.
allow_late_uploads String? If set, allow uploads after the deadline has passed. Might be missing due to historical data gap. This field is optional.
submitter_name String? The name as provided by the submitter. Might be missing due to historical data gap. This field is optional.
submitter_email String(max_length=255)? The email as provided by the submitter. Might be missing due to historical data gap. This field is optional.
group_add_external_id_details GroupAddExternalIdDetails
GroupAddExternalIdDetails
Added external ID for group.
new_value String Current external id.
group_add_member_details GroupAddMemberDetails
GroupAddMemberDetails
Added team members to group.
is_group_owner Boolean Is group owner.
group_change_external_id_details GroupChangeExternalIdDetails
GroupChangeExternalIdDetails
Changed external ID for group.
new_value String Current external id.
previous_value String Old external id.
group_change_management_type_details GroupChangeManagementTypeDetails
GroupChangeManagementTypeDetails
Changed group management type.
new_value GroupManagementType New group management type.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
previous_value GroupManagementType? Previous group management type. Might be missing due to historical data gap. This field is optional.
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.
user_managed Void A group which is managed by selected users.
company_managed Void A group which is managed by team admins only.
system_managed Void A group which is managed automatically by Dropbox.
group_change_member_role_details GroupChangeMemberRoleDetails
GroupChangeMemberRoleDetails
Changed manager permissions of group member.
is_group_owner Boolean Is group owner.
group_create_details GroupCreateDetails
GroupCreateDetails
Created group.
is_company_managed Boolean? Is company managed group. Might be missing due to historical data gap. This field is optional.
join_policy GroupJoinPolicy? Group join policy. This field is optional.
GroupJoinPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
open Void
request_to_join Void
group_delete_details GroupDeleteDetails
GroupDeleteDetails
Deleted group.
is_company_managed Boolean? Is company managed group. Might be missing due to historical data gap. This field is optional.
group_description_updated_details GroupDescriptionUpdatedDetails
GroupDescriptionUpdatedDetails
Updated group.
group_join_policy_updated_details GroupJoinPolicyUpdatedDetails
GroupJoinPolicyUpdatedDetails
Updated group join policy.
is_company_managed Boolean? Is company managed group. Might be missing due to historical data gap. This field is optional.
join_policy GroupJoinPolicy? Group join policy. This field is optional.
GroupJoinPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
open Void
request_to_join Void
group_moved_details GroupMovedDetails
GroupMovedDetails
Moved group.
group_remove_external_id_details GroupRemoveExternalIdDetails
GroupRemoveExternalIdDetails
Removed external ID for group.
previous_value String Old external id.
group_remove_member_details GroupRemoveMemberDetails
GroupRemoveMemberDetails
Removed team members from group.
group_rename_details GroupRenameDetails
GroupRenameDetails
Renamed group.
previous_value String Previous display name.
new_value String New display name.
emm_error_details EmmErrorDetails
EmmErrorDetails
Failed to sign in via EMM.
error_details FailureDetailsLogInfo Error details.
FailureDetailsLogInfo
Provides details about a failure
user_friendly_message String? A user friendly explanation of the error. Might be missing due to historical data gap. This field is optional.
technical_error_message String? A technical explanation of the error. This is relevant for some errors. This field is optional.
login_fail_details LoginFailDetails
LoginFailDetails
Failed to sign in.
login_method LoginMethod Login method.
LoginMethod (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
password Void
two_factor_authentication Void
saml Void
error_details FailureDetailsLogInfo Error details.
FailureDetailsLogInfo
Provides details about a failure
user_friendly_message String? A user friendly explanation of the error. Might be missing due to historical data gap. This field is optional.
technical_error_message String? A technical explanation of the error. This is relevant for some errors. This field is optional.
is_emm_managed Boolean? Tells if the login device is EMM managed. Might be missing due to historical data gap. This field is optional.
login_success_details LoginSuccessDetails
LoginSuccessDetails
Signed in.
login_method LoginMethod Login method.
LoginMethod (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
password Void
two_factor_authentication Void
saml Void
is_emm_managed Boolean? Tells if the login device is EMM managed. Might be missing due to historical data gap. This field is optional.
logout_details LogoutDetails
LogoutDetails
Signed out.
reseller_support_session_end_details ResellerSupportSessionEndDetails
ResellerSupportSessionEndDetails
Ended reseller support session.
reseller_support_session_start_details ResellerSupportSessionStartDetails
ResellerSupportSessionStartDetails
Started reseller support session.
sign_in_as_session_end_details SignInAsSessionEndDetails
SignInAsSessionEndDetails
Ended admin sign-in-as session.
sign_in_as_session_start_details SignInAsSessionStartDetails
SignInAsSessionStartDetails
Started admin sign-in-as session.
sso_error_details SsoErrorDetails
SsoErrorDetails
Failed to sign in via SSO.
error_details FailureDetailsLogInfo Error details.
FailureDetailsLogInfo
Provides details about a failure
user_friendly_message String? A user friendly explanation of the error. Might be missing due to historical data gap. This field is optional.
technical_error_message String? A technical explanation of the error. This is relevant for some errors. This field is optional.
member_add_name_details MemberAddNameDetails
MemberAddNameDetails
Added team member name.
new_value UserNameLogInfo New user's name.
UserNameLogInfo
User's name logged information
given_name String Given name.
surname String Surname.
locale String? Locale. Might be missing due to historical data gap. This field is optional.
member_change_admin_role_details MemberChangeAdminRoleDetails
MemberChangeAdminRoleDetails
Changed team member admin role.
new_value AdminRole? New admin role. This field is relevant when the admin role is changed or whenthe user role changes from no admin rights to with admin rights. This field is optional.
AdminRole (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
team_admin Void
user_management_admin Void
support_admin Void
limited_admin Void
member_only Void
previous_value AdminRole? Previous admin role. This field is relevant when the admin role is changed or when the admin role is removed. This field is optional.
AdminRole (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
team_admin Void
user_management_admin Void
support_admin Void
limited_admin Void
member_only Void
member_change_email_details MemberChangeEmailDetails
MemberChangeEmailDetails
Changed team member email.
new_value String(max_length=255) New email.
previous_value String(max_length=255)? Previous email. Might be missing due to historical data gap. This field is optional.
member_change_membership_type_details MemberChangeMembershipTypeDetails
MemberChangeMembershipTypeDetails
Changed membership type (limited/full) of member.
prev_value TeamMembershipType Previous membership type.
TeamMembershipType (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
free Void
full Void
new_value TeamMembershipType New membership type.
TeamMembershipType (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
free Void
full Void
member_change_name_details MemberChangeNameDetails
MemberChangeNameDetails
Changed team member name.
new_value UserNameLogInfo New user's name.
UserNameLogInfo
User's name logged information
given_name String Given name.
surname String Surname.
locale String? Locale. Might be missing due to historical data gap. This field is optional.
previous_value UserNameLogInfo? Previous user's name. Might be missing due to historical data gap. This field is optional.
UserNameLogInfo
User's name logged information
given_name String Given name.
surname String Surname.
locale String? Locale. Might be missing due to historical data gap. This field is optional.
member_change_status_details MemberChangeStatusDetails
MemberChangeStatusDetails
Changed member status (invited, joined, suspended, etc.).
new_value MemberStatus New member status.
MemberStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
not_joined Void
invited Void
active Void
suspended Void
removed Void
previous_value MemberStatus? Previous member status. Might be missing due to historical data gap. This field is optional.
MemberStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
not_joined Void
invited Void
active Void
suspended Void
removed Void
action ActionDetails? Additional information indicating the action taken that caused status change. This field is optional.
ActionDetails (open union)
Additional information indicating the action taken that caused status change. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team_join_details JoinTeamDetails Additional information relevant when a new member joins the team.
JoinTeamDetails
Additional information relevant when a new member joins the team.
linked_apps List of (UserLinkedAppLogInfo) Linked applications.
UserLinkedAppLogInfo
User linked app
app_id String? App unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? App display name. Might be missing due to historical data gap. This field is optional.
linked_devices List of (LinkedDeviceLogInfo) Linked devices.
LinkedDeviceLogInfo (open union)
The device sessions that user is linked to. The value will be one of the following datatypes. New values may be introduced as our API evolves.
mobile_device_session MobileDeviceSessionLogInfo mobile device session's details.
MobileDeviceSessionLogInfo
Information about linked Dropbox mobile client sessions
device_name String The device name.
client_type MobileClientPlatform The mobile application type.
MobileClientPlatform (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
iphone Void Official Dropbox iPhone client.
ipad Void Official Dropbox iPad client.
android Void Official Dropbox Android client.
windows_phone Void Official Dropbox Windows phone client.
blackberry Void Official Dropbox Blackberry client.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info MobileSessionLogInfo? Mobile session unique id. Might be missing due to historical data gap. This field is optional.
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. This field is optional.
os_version String? The hosting OS version. This field is optional.
last_carrier String? last carrier used by the device. This field is optional.
desktop_device_session DesktopDeviceSessionLogInfo desktop device session's details.
DesktopDeviceSessionLogInfo
Information about linked Dropbox desktop client sessions
host_name String Name of the hosting desktop.
client_type DesktopPlatform The Dropbox desktop client type.
DesktopPlatform (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
windows Void Official Windows Dropbox desktop client.
mac Void Official Mac Dropbox desktop client.
linux Void Official Linux Dropbox desktop client.
platform String Information on the hosting platform.
is_delete_on_unlink_supported Boolean Whether itu2019s possible to delete all of the account files upon unlinking.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info DesktopSessionLogInfo? Desktop session unique id. Might be missing due to historical data gap. This field is optional.
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. This field is optional.
web_device_session WebDeviceSessionLogInfo web device session's details.
WebDeviceSessionLogInfo
Information on active web sessions
user_agent String Information on the hosting device.
os String Information on the hosting operating system.
browser String Information on the browser used for this web session.
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info WebSessionLogInfo? Web session unique id. Might be missing due to historical data gap. This field is optional.
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
legacy_device_session LegacyDeviceSessionLogInfo legacy device session's details.
LegacyDeviceSessionLogInfo
Information on sessions, in legacy format
ip_address String? The IP address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
created Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time this session was created. Might be missing due to historical data gap. This field is optional.
updated Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? The time of the last activity from this session. Might be missing due to historical data gap. This field is optional.
session_info SessionLogInfo? Session unique id. Might be missing due to historical data gap. This field is optional.
SessionLogInfo (datatype with subtypes)
Session's logged information. This datatype will be one of the following subtypes:
web WebSessionLogInfo
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
desktop DesktopSessionLogInfo
DesktopSessionLogInfo
Desktop session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
mobile MobileSessionLogInfo
MobileSessionLogInfo
Mobile session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
display_name String? The device name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? Is device managed by emm. Might be missing due to historical data gap. This field is optional.
platform String? Information on the hosting platform. Might be missing due to historical data gap. This field is optional.
mac_address String? The mac address of the last activity from this session. Might be missing due to historical data gap. This field is optional.
os_version String? The hosting OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Information on the hosting device type. Might be missing due to historical data gap. This field is optional.
client_version String? The Dropbox client version. Might be missing due to historical data gap. This field is optional.
legacy_uniq_id String? Alternative unique device session id, instead of session id field. Might be missing due to historical data gap. This field is optional.
linked_shared_folders List of (FolderLogInfo) Linked shared folders.
FolderLogInfo
Folder's logged information.
path PathLogInfo Path relative to event context.
PathLogInfo
Path's details.
namespace_relative NamespaceRelativePathLogInfo Path relative to the namespace containing the content.
NamespaceRelativePathLogInfo
Namespace relative path details.
ns_id String? Namespace ID. Might be missing due to historical data gap. This field is optional.
relative_path String? A path relative to the specified namespace ID. Might be missing due to historical data gap. This field is optional.
contextual String? Fully qualified path relative to event's context. Might be missing due to historical data gap. This field is optional.
display_name String? Display name. Might be missing due to historical data gap. This field is optional.
file_id String? Unique ID. Might be missing due to historical data gap. This field is optional.
remove_action MemberRemoveActionType Define how the user was removed from the team.
MemberRemoveActionType (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
delete Void
offboard Void
leave Void
member_delete_manual_contacts_details MemberDeleteManualContactsDetails
MemberDeleteManualContactsDetails
Cleared manually added contacts.
member_permanently_delete_account_contents_details MemberPermanentlyDeleteAccountContentsDetails
MemberPermanentlyDeleteAccountContentsDetails
Permanently deleted contents of deleted team member account.
member_space_limits_add_custom_quota_details MemberSpaceLimitsAddCustomQuotaDetails
MemberSpaceLimitsAddCustomQuotaDetails
Set custom member space limit.
new_value UInt64 New custom quota value in bytes.
member_space_limits_change_custom_quota_details MemberSpaceLimitsChangeCustomQuotaDetails
MemberSpaceLimitsChangeCustomQuotaDetails
Changed custom member space limit.
previous_value UInt64 Previous custom quota value in bytes.
new_value UInt64 New custom quota value in bytes.
member_space_limits_change_status_details MemberSpaceLimitsChangeStatusDetails
MemberSpaceLimitsChangeStatusDetails
Changed space limit status.
previous_value SpaceLimitsStatus Previous storage quota status.
SpaceLimitsStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
within_quota Void
near_quota Void
over_quota Void
new_value SpaceLimitsStatus New storage quota status.
SpaceLimitsStatus (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
within_quota Void
near_quota Void
over_quota Void
member_space_limits_remove_custom_quota_details MemberSpaceLimitsRemoveCustomQuotaDetails
MemberSpaceLimitsRemoveCustomQuotaDetails
Removed custom member space limit.
member_suggest_details MemberSuggestDetails
MemberSuggestDetails
Suggested person to add to team.
suggested_members List of (String(max_length=255)) suggested users emails.
member_transfer_account_contents_details MemberTransferAccountContentsDetails
MemberTransferAccountContentsDetails
Transferred contents of deleted member account to another member.
secondary_mails_policy_changed_details SecondaryMailsPolicyChangedDetails
SecondaryMailsPolicyChangedDetails
Secondary mails policy changed.
previous_value SecondaryMailsPolicy Previous secondary mails policy.
SecondaryMailsPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
new_value SecondaryMailsPolicy New secondary mails policy.
SecondaryMailsPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
paper_content_add_member_details PaperContentAddMemberDetails
PaperContentAddMemberDetails
Added team member to Paper doc/folder.
event_uuid String Event unique identifier.
paper_content_add_to_folder_details PaperContentAddToFolderDetails
PaperContentAddToFolderDetails
Added Paper doc/folder to folder.
event_uuid String Event unique identifier.
target_asset_index UInt64 Target asset position in the Assets list.
parent_asset_index UInt64 Parent asset position in the Assets list.
paper_content_archive_details PaperContentArchiveDetails
PaperContentArchiveDetails
Archived Paper doc/folder.
event_uuid String Event unique identifier.
paper_content_create_details PaperContentCreateDetails
PaperContentCreateDetails
Created Paper doc/folder.
event_uuid String Event unique identifier.
paper_content_permanently_delete_details PaperContentPermanentlyDeleteDetails
PaperContentPermanentlyDeleteDetails
Permanently deleted Paper doc/folder.
event_uuid String Event unique identifier.
paper_content_remove_from_folder_details PaperContentRemoveFromFolderDetails
PaperContentRemoveFromFolderDetails
Removed Paper doc/folder from folder.
event_uuid String Event unique identifier.
target_asset_index UInt64 Target asset position in the Assets list.
parent_asset_index UInt64 Parent asset position in the Assets list.
paper_content_remove_member_details PaperContentRemoveMemberDetails
PaperContentRemoveMemberDetails
Removed team member from Paper doc/folder.
event_uuid String Event unique identifier.
paper_content_rename_details PaperContentRenameDetails
PaperContentRenameDetails
Renamed Paper doc/folder.
event_uuid String Event unique identifier.
paper_content_restore_details PaperContentRestoreDetails
PaperContentRestoreDetails
Restored archived Paper doc/folder.
event_uuid String Event unique identifier.
paper_doc_add_comment_details PaperDocAddCommentDetails
PaperDocAddCommentDetails
Added Paper doc comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
paper_doc_change_member_role_details PaperDocChangeMemberRoleDetails
PaperDocChangeMemberRoleDetails
Changed team member permissions for Paper doc.
event_uuid String Event unique identifier.
access_type PaperAccessType Paper doc access type.
PaperAccessType (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
viewer Void
commenter Void
editor Void
paper_doc_change_sharing_policy_details PaperDocChangeSharingPolicyDetails
PaperDocChangeSharingPolicyDetails
Changed sharing setting for Paper doc.
event_uuid String Event unique identifier.
public_sharing_policy String? Sharing policy with external users. Might be missing due to historical data gap. This field is optional.
team_sharing_policy String? Sharing policy with team. Might be missing due to historical data gap. This field is optional.
paper_doc_change_subscription_details PaperDocChangeSubscriptionDetails
PaperDocChangeSubscriptionDetails
Followed/unfollowed Paper doc.
event_uuid String Event unique identifier.
new_subscription_level String New doc subscription level.
previous_subscription_level String? Previous doc subscription level. Might be missing due to historical data gap. This field is optional.
paper_doc_deleted_details PaperDocDeletedDetails
PaperDocDeletedDetails
Archived Paper doc.
event_uuid String Event unique identifier.
paper_doc_delete_comment_details PaperDocDeleteCommentDetails
PaperDocDeleteCommentDetails
Deleted Paper doc comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
paper_doc_download_details PaperDocDownloadDetails
PaperDocDownloadDetails
Downloaded Paper doc in specific format.
event_uuid String Event unique identifier.
export_file_format PaperDownloadFormat Export file format.
PaperDownloadFormat (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
docx Void
html Void
markdown Void
pdf Void
paper_doc_edit_details PaperDocEditDetails
PaperDocEditDetails
Edited Paper doc.
event_uuid String Event unique identifier.
paper_doc_edit_comment_details PaperDocEditCommentDetails
PaperDocEditCommentDetails
Edited Paper doc comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
paper_doc_followed_details PaperDocFollowedDetails
PaperDocFollowedDetails
Followed Paper doc.
event_uuid String Event unique identifier.
paper_doc_mention_details PaperDocMentionDetails
PaperDocMentionDetails
Mentioned team member in Paper doc.
event_uuid String Event unique identifier.
paper_doc_ownership_changed_details PaperDocOwnershipChangedDetails
PaperDocOwnershipChangedDetails
Transferred ownership of Paper doc.
event_uuid String Event unique identifier.
new_owner_user_id String(min_length=40, max_length=40) New owner.
old_owner_user_id String(min_length=40, max_length=40)? Previous owner. This field is optional.
paper_doc_request_access_details PaperDocRequestAccessDetails
PaperDocRequestAccessDetails
Requested access to Paper doc.
event_uuid String Event unique identifier.
paper_doc_resolve_comment_details PaperDocResolveCommentDetails
PaperDocResolveCommentDetails
Resolved Paper doc comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
paper_doc_revert_details PaperDocRevertDetails
PaperDocRevertDetails
Restored Paper doc to previous version.
event_uuid String Event unique identifier.
paper_doc_slack_share_details PaperDocSlackShareDetails
PaperDocSlackShareDetails
Shared Paper doc via Slack.
event_uuid String Event unique identifier.
paper_doc_team_invite_details PaperDocTeamInviteDetails
PaperDocTeamInviteDetails
Shared Paper doc with team member.
event_uuid String Event unique identifier.
paper_doc_trashed_details PaperDocTrashedDetails
PaperDocTrashedDetails
Deleted Paper doc.
event_uuid String Event unique identifier.
paper_doc_unresolve_comment_details PaperDocUnresolveCommentDetails
PaperDocUnresolveCommentDetails
Unresolved Paper doc comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. Might be missing due to historical data gap. This field is optional.
paper_doc_untrashed_details PaperDocUntrashedDetails
PaperDocUntrashedDetails
Restored Paper doc.
event_uuid String Event unique identifier.
paper_doc_view_details PaperDocViewDetails
PaperDocViewDetails
Viewed Paper doc.
event_uuid String Event unique identifier.
paper_external_view_allow_details PaperExternalViewAllowDetails
PaperExternalViewAllowDetails
Changed Paper external sharing setting to anyone.
event_uuid String Event unique identifier.
paper_external_view_default_team_details PaperExternalViewDefaultTeamDetails
PaperExternalViewDefaultTeamDetails
Changed Paper external sharing setting to default team.
event_uuid String Event unique identifier.
paper_external_view_forbid_details PaperExternalViewForbidDetails
PaperExternalViewForbidDetails
Changed Paper external sharing setting to team-only.
event_uuid String Event unique identifier.
paper_folder_change_subscription_details PaperFolderChangeSubscriptionDetails
PaperFolderChangeSubscriptionDetails
Followed/unfollowed Paper folder.
event_uuid String Event unique identifier.
new_subscription_level String New folder subscription level.
previous_subscription_level String? Previous folder subscription level. Might be missing due to historical data gap. This field is optional.
paper_folder_deleted_details PaperFolderDeletedDetails
PaperFolderDeletedDetails
Archived Paper folder.
event_uuid String Event unique identifier.
paper_folder_followed_details PaperFolderFollowedDetails
PaperFolderFollowedDetails
Followed Paper folder.
event_uuid String Event unique identifier.
paper_folder_team_invite_details PaperFolderTeamInviteDetails
PaperFolderTeamInviteDetails
Shared Paper folder with member.
event_uuid String Event unique identifier.
password_change_details PasswordChangeDetails
PasswordChangeDetails
Changed password.
password_reset_details PasswordResetDetails
PasswordResetDetails
Reset password.
password_reset_all_details PasswordResetAllDetails
PasswordResetAllDetails
Reset all team member passwords.
emm_create_exceptions_report_details EmmCreateExceptionsReportDetails
EmmCreateExceptionsReportDetails
Created EMM-excluded users report.
emm_create_usage_report_details EmmCreateUsageReportDetails
EmmCreateUsageReportDetails
Created EMM mobile app usage report.
export_members_report_details ExportMembersReportDetails
ExportMembersReportDetails
Created member data report.
paper_admin_export_start_details PaperAdminExportStartDetails
PaperAdminExportStartDetails
Exported all team Paper docs.
smart_sync_create_admin_privilege_report_details SmartSyncCreateAdminPrivilegeReportDetails
SmartSyncCreateAdminPrivilegeReportDetails
Created Smart Sync non-admin devices report.
team_activity_create_report_details TeamActivityCreateReportDetails
TeamActivityCreateReportDetails
Created team activity report.
start_date Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Report start date.
end_date Timestamp(format="%Y-%m-%dT%H:%M:%SZ") Report end date.
collection_share_details CollectionShareDetails
CollectionShareDetails
Shared album.
album_name String Album name.
note_acl_invite_only_details NoteAclInviteOnlyDetails
NoteAclInviteOnlyDetails
Changed Paper doc to invite-only.
note_acl_link_details NoteAclLinkDetails
NoteAclLinkDetails
Changed Paper doc to link-accessible.
note_acl_team_link_details NoteAclTeamLinkDetails
NoteAclTeamLinkDetails
Changed Paper doc to link-accessible for team.
note_shared_details NoteSharedDetails
NoteSharedDetails
Shared Paper doc.
note_share_receive_details NoteShareReceiveDetails
NoteShareReceiveDetails
Shared received Paper doc.
open_note_shared_details OpenNoteSharedDetails
OpenNoteSharedDetails
Opened shared Paper doc.
sf_add_group_details SfAddGroupDetails
SfAddGroupDetails
Added team to shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
team_name String Team name.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
sf_allow_non_members_to_view_shared_links_details SfAllowNonMembersToViewSharedLinksDetails
SfAllowNonMembersToViewSharedLinksDetails
Allowed non-collaborators to view links to files in shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
sf_external_invite_warn_details SfExternalInviteWarnDetails
SfExternalInviteWarnDetails
Set team members to see warning before sharing folders outside team.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
new_sharing_permission String? New sharing permission. Might be missing due to historical data gap. This field is optional.
previous_sharing_permission String? Previous sharing permission. Might be missing due to historical data gap. This field is optional.
sf_fb_invite_details SfFbInviteDetails
SfFbInviteDetails
Invited Facebook users to shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
sf_fb_invite_change_role_details SfFbInviteChangeRoleDetails
SfFbInviteChangeRoleDetails
Changed Facebook user's role in shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
previous_sharing_permission String? Previous sharing permission. Might be missing due to historical data gap. This field is optional.
new_sharing_permission String? New sharing permission. Might be missing due to historical data gap. This field is optional.
sf_fb_uninvite_details SfFbUninviteDetails
SfFbUninviteDetails
Uninvited Facebook user from shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
sf_invite_group_details SfInviteGroupDetails
SfInviteGroupDetails
Invited group to shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
sf_team_grant_access_details SfTeamGrantAccessDetails
SfTeamGrantAccessDetails
Granted access to shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
sf_team_invite_details SfTeamInviteDetails
SfTeamInviteDetails
Invited team members to shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
sf_team_invite_change_role_details SfTeamInviteChangeRoleDetails
SfTeamInviteChangeRoleDetails
Changed team member's role in shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
new_sharing_permission String? New sharing permission. Might be missing due to historical data gap. This field is optional.
previous_sharing_permission String? Previous sharing permission. Might be missing due to historical data gap. This field is optional.
sf_team_join_details SfTeamJoinDetails
SfTeamJoinDetails
Joined team member's shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
sf_team_join_from_oob_link_details SfTeamJoinFromOobLinkDetails
SfTeamJoinFromOobLinkDetails
Joined team member's shared folder from link.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
token_key String? Shared link token key. This field is optional.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
sf_team_uninvite_details SfTeamUninviteDetails
SfTeamUninviteDetails
Unshared folder with team member.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
shared_content_add_invitees_details SharedContentAddInviteesDetails
SharedContentAddInviteesDetails
Invited user to Dropbox and added them to shared file/folder.
shared_content_access_level AccessLevel Shared content access level.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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.
invitees List of (String(max_length=255)) A list of invitees.
shared_content_add_link_expiry_details SharedContentAddLinkExpiryDetails
SharedContentAddLinkExpiryDetails
Added expiration date to link for shared file/folder.
new_value Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? New shared content link expiration date. Might be missing due to historical data gap. This field is optional.
shared_content_add_link_password_details SharedContentAddLinkPasswordDetails
SharedContentAddLinkPasswordDetails
Added password to link for shared file/folder.
shared_content_add_member_details SharedContentAddMemberDetails
SharedContentAddMemberDetails
Added users and/or groups to shared file/folder.
shared_content_access_level AccessLevel Shared content access level.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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.
shared_content_change_downloads_policy_details SharedContentChangeDownloadsPolicyDetails
SharedContentChangeDownloadsPolicyDetails
Changed whether members can download shared file/folder.
new_value DownloadPolicyType New downloads policy.
DownloadPolicyType (open union)
Shared content downloads policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
allow Void
disallow Void
previous_value DownloadPolicyType? Previous downloads policy. Might be missing due to historical data gap. This field is optional.
DownloadPolicyType (open union)
Shared content downloads policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
allow Void
disallow Void
shared_content_change_invitee_role_details SharedContentChangeInviteeRoleDetails
SharedContentChangeInviteeRoleDetails
Changed access type of invitee to shared file/folder before invite was accepted.
new_access_level AccessLevel New access level.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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 String(max_length=255) The invitee whose role was changed.
previous_access_level AccessLevel? Previous access level. Might be missing due to historical data gap. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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.
shared_content_change_link_audience_details SharedContentChangeLinkAudienceDetails
SharedContentChangeLinkAudienceDetails
Changed link audience of shared file/folder.
new_value LinkAudience New link audience value.
LinkAudience (open union)
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.
public Void Link is accessible by anyone.
team Void Link is accessible only by team members.
members Void Link is accessible only by members of the content.
previous_value LinkAudience? Previous link audience value. This field is optional.
LinkAudience (open union)
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.
public Void Link is accessible by anyone.
team Void Link is accessible only by team members.
members Void Link is accessible only by members of the content.
shared_content_change_link_expiry_details SharedContentChangeLinkExpiryDetails
SharedContentChangeLinkExpiryDetails
Changed link expiration of shared file/folder.
new_value Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? New shared content link expiration date. Might be missing due to historical data gap. This field is optional.
previous_value Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Previous shared content link expiration date. Might be missing due to historical data gap. This field is optional.
shared_content_change_link_password_details SharedContentChangeLinkPasswordDetails
SharedContentChangeLinkPasswordDetails
Changed link password of shared file/folder.
shared_content_change_member_role_details SharedContentChangeMemberRoleDetails
SharedContentChangeMemberRoleDetails
Changed access type of shared file/folder member.
new_access_level AccessLevel New access level.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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.
previous_access_level AccessLevel? Previous access level. Might be missing due to historical data gap. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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.
shared_content_change_viewer_info_policy_details SharedContentChangeViewerInfoPolicyDetails
SharedContentChangeViewerInfoPolicyDetails
Changed whether members can see who viewed shared file/folder.
new_value ViewerInfoPolicy New viewer info policy.
ViewerInfoPolicy (open union)
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.
enabled Void Viewer information is available on this file.
disabled Void Viewer information is disabled on this file.
previous_value ViewerInfoPolicy? Previous view info policy. Might be missing due to historical data gap. This field is optional.
ViewerInfoPolicy (open union)
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.
enabled Void Viewer information is available on this file.
disabled Void Viewer information is disabled on this file.
shared_content_claim_invitation_details SharedContentClaimInvitationDetails
SharedContentClaimInvitationDetails
Acquired membership of shared file/folder by accepting invite.
shared_content_link String? Shared content link. This field is optional.
shared_content_copy_details SharedContentCopyDetails
SharedContentCopyDetails
Copied shared file/folder to own Dropbox.
shared_content_link String Shared content link.
shared_content_access_level AccessLevel Shared content access level.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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.
destination_path String The path where the member saved the content.
shared_content_owner UserLogInfo? The shared content owner. This field is optional.
UserLogInfo (datatype with subtypes)
User's logged information. This datatype will be one of the following subtypes:
team_member TeamMemberLogInfo
TeamMemberLogInfo
Team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
team_member_id String? Team member ID. Might be missing due to historical data gap. This field is optional.
member_external_id String(max_length=64)? Team member external ID. This field is optional.
non_team_member NonTeamMemberLogInfo
NonTeamMemberLogInfo
Non team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
shared_content_download_details SharedContentDownloadDetails
SharedContentDownloadDetails
Downloaded shared file/folder.
shared_content_link String Shared content link.
shared_content_access_level AccessLevel Shared content access level.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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.
shared_content_owner UserLogInfo? The shared content owner. This field is optional.
UserLogInfo (datatype with subtypes)
User's logged information. This datatype will be one of the following subtypes:
team_member TeamMemberLogInfo
TeamMemberLogInfo
Team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
team_member_id String? Team member ID. Might be missing due to historical data gap. This field is optional.
member_external_id String(max_length=64)? Team member external ID. This field is optional.
non_team_member NonTeamMemberLogInfo
NonTeamMemberLogInfo
Non team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
shared_content_relinquish_membership_details SharedContentRelinquishMembershipDetails
SharedContentRelinquishMembershipDetails
Left shared file/folder.
shared_content_remove_invitees_details SharedContentRemoveInviteesDetails
SharedContentRemoveInviteesDetails
Removed invitee from shared file/folder before invite was accepted.
invitees List of (String(max_length=255)) A list of invitees.
shared_content_remove_link_expiry_details SharedContentRemoveLinkExpiryDetails
SharedContentRemoveLinkExpiryDetails
Removed link expiration date of shared file/folder.
previous_value Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Previous shared content link expiration date. Might be missing due to historical data gap. This field is optional.
shared_content_remove_link_password_details SharedContentRemoveLinkPasswordDetails
SharedContentRemoveLinkPasswordDetails
Removed link password of shared file/folder.
shared_content_remove_member_details SharedContentRemoveMemberDetails
SharedContentRemoveMemberDetails
Removed user/group from shared file/folder.
shared_content_access_level AccessLevel? Shared content access level. This field is optional.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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.
shared_content_request_access_details SharedContentRequestAccessDetails
SharedContentRequestAccessDetails
Requested access to shared file/folder.
shared_content_link String? Shared content link. This field is optional.
shared_content_unshare_details SharedContentUnshareDetails
SharedContentUnshareDetails
Unshared file/folder by clearing membership and turning off link.
shared_content_view_details SharedContentViewDetails
SharedContentViewDetails
Previewed shared file/folder.
shared_content_link String Shared content link.
shared_content_access_level AccessLevel Shared content access level.
AccessLevel (open union)
Defines the access levels for collaborators. 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.
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.
shared_content_owner UserLogInfo? The shared content owner. This field is optional.
UserLogInfo (datatype with subtypes)
User's logged information. This datatype will be one of the following subtypes:
team_member TeamMemberLogInfo
TeamMemberLogInfo
Team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
team_member_id String? Team member ID. Might be missing due to historical data gap. This field is optional.
member_external_id String(max_length=64)? Team member external ID. This field is optional.
non_team_member NonTeamMemberLogInfo
NonTeamMemberLogInfo
Non team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
shared_folder_change_link_policy_details SharedFolderChangeLinkPolicyDetails
SharedFolderChangeLinkPolicyDetails
Changed who can access shared folder via link.
new_value SharedLinkPolicy New shared folder link policy.
SharedLinkPolicy (open union)
Who can view shared links in this 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.
anyone Void Links can be shared with anyone.
team Void Links can be shared with anyone on the same team as the owner.
members Void Links can only be shared among members of the shared folder.
previous_value SharedLinkPolicy? Previous shared folder link policy. Might be missing due to historical data gap. This field is optional.
SharedLinkPolicy (open union)
Who can view shared links in this 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.
anyone Void Links can be shared with anyone.
team Void Links can be shared with anyone on the same team as the owner.
members Void Links can only be shared among members of the shared folder.
shared_folder_change_members_inheritance_policy_details SharedFolderChangeMembersInheritancePolicyDetails
SharedFolderChangeMembersInheritancePolicyDetails
Changed whether shared folder inherits members from parent folder.
new_value SharedFolderMembersInheritancePolicy New member inheritance policy.
SharedFolderMembersInheritancePolicy (open union)
Specifies if a shared folder inherits its members from the parent folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
inherit_members Void
dont_inherit_members Void
previous_value SharedFolderMembersInheritancePolicy? Previous member inheritance policy. Might be missing due to historical data gap. This field is optional.
SharedFolderMembersInheritancePolicy (open union)
Specifies if a shared folder inherits its members from the parent folder. The value will be one of the following datatypes. New values may be introduced as our API evolves.
inherit_members Void
dont_inherit_members Void
shared_folder_change_members_management_policy_details SharedFolderChangeMembersManagementPolicyDetails
SharedFolderChangeMembersManagementPolicyDetails
Changed who can add/remove members of shared folder.
new_value AclUpdatePolicy New members management policy.
AclUpdatePolicy (open union)
Who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. 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.
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.
previous_value AclUpdatePolicy? Previous members management policy. Might be missing due to historical data gap. This field is optional.
AclUpdatePolicy (open union)
Who can change a shared folder's access control list (ACL). In other words, who can add, remove, or change the privileges of members. 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.
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_folder_change_members_policy_details SharedFolderChangeMembersPolicyDetails
SharedFolderChangeMembersPolicyDetails
Changed who can become member of shared folder.
new_value MemberPolicy New external invite policy.
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. 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.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
previous_value MemberPolicy? Previous external invite policy. Might be missing due to historical data gap. 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. 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.
team Void Only a teammate can become a member.
anyone Void Anyone can become a member.
shared_folder_create_details SharedFolderCreateDetails
SharedFolderCreateDetails
Created shared folder.
target_ns_id String? Target namespace ID. Might be missing due to historical data gap. This field is optional.
shared_folder_decline_invitation_details SharedFolderDeclineInvitationDetails
SharedFolderDeclineInvitationDetails
Declined team member's invite to shared folder.
shared_folder_mount_details SharedFolderMountDetails
SharedFolderMountDetails
Added shared folder to own Dropbox.
shared_folder_nest_details SharedFolderNestDetails
SharedFolderNestDetails
Changed parent of shared folder.
previous_parent_ns_id String? Previous parent namespace ID. Might be missing due to historical data gap. This field is optional.
new_parent_ns_id String? New parent namespace ID. Might be missing due to historical data gap. This field is optional.
previous_ns_path String? Previous namespace path. Might be missing due to historical data gap. This field is optional.
new_ns_path String? New namespace path. Might be missing due to historical data gap. This field is optional.
shared_folder_transfer_ownership_details SharedFolderTransferOwnershipDetails
SharedFolderTransferOwnershipDetails
Transferred ownership of shared folder to another member.
new_owner_email String(max_length=255) The email address of the new shared folder owner.
previous_owner_email String(max_length=255)? The email address of the previous shared folder owner. This field is optional.
shared_folder_unmount_details SharedFolderUnmountDetails
SharedFolderUnmountDetails
Deleted shared folder from Dropbox.
shared_link_add_expiry_details SharedLinkAddExpiryDetails
SharedLinkAddExpiryDetails
Added shared link expiration date.
new_value Timestamp(format="%Y-%m-%dT%H:%M:%SZ") New shared link expiration date.
shared_link_change_expiry_details SharedLinkChangeExpiryDetails
SharedLinkChangeExpiryDetails
Changed shared link expiration date.
new_value Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? New shared link expiration date. Might be missing due to historical data gap. This field is optional.
previous_value Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Previous shared link expiration date. Might be missing due to historical data gap. This field is optional.
shared_link_change_visibility_details SharedLinkChangeVisibilityDetails
SharedLinkChangeVisibilityDetails
Changed visibility of shared link.
new_value SharedLinkVisibility New shared link visibility.
SharedLinkVisibility (open union)
Defines who has access to a shared link. The value will be one of the following datatypes. New values may be introduced as our API evolves.
password Void
public Void
team_only Void
previous_value SharedLinkVisibility? Previous shared link visibility. Might be missing due to historical data gap. This field is optional.
SharedLinkVisibility (open union)
Defines who has access to a shared link. The value will be one of the following datatypes. New values may be introduced as our API evolves.
password Void
public Void
team_only Void
shared_link_copy_details SharedLinkCopyDetails
SharedLinkCopyDetails
Added file/folder to Dropbox from shared link.
shared_link_owner UserLogInfo? Shared link owner details. Might be missing due to historical data gap. This field is optional.
UserLogInfo (datatype with subtypes)
User's logged information. This datatype will be one of the following subtypes:
team_member TeamMemberLogInfo
TeamMemberLogInfo
Team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
team_member_id String? Team member ID. Might be missing due to historical data gap. This field is optional.
member_external_id String(max_length=64)? Team member external ID. This field is optional.
non_team_member NonTeamMemberLogInfo
NonTeamMemberLogInfo
Non team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
shared_link_create_details SharedLinkCreateDetails
SharedLinkCreateDetails
Created shared link.
shared_link_access_level SharedLinkAccessLevel? Defines who can access the shared link. Might be missing due to historical data gap. This field is optional.
SharedLinkAccessLevel (open union)
Shared link access level. The value will be one of the following datatypes. New values may be introduced as our API evolves.
none Void
reader Void
writer Void
shared_link_disable_details SharedLinkDisableDetails
SharedLinkDisableDetails
Removed shared link.
shared_link_owner UserLogInfo? Shared link owner details. Might be missing due to historical data gap. This field is optional.
UserLogInfo (datatype with subtypes)
User's logged information. This datatype will be one of the following subtypes:
team_member TeamMemberLogInfo
TeamMemberLogInfo
Team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
team_member_id String? Team member ID. Might be missing due to historical data gap. This field is optional.
member_external_id String(max_length=64)? Team member external ID. This field is optional.
non_team_member NonTeamMemberLogInfo
NonTeamMemberLogInfo
Non team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
shared_link_download_details SharedLinkDownloadDetails
SharedLinkDownloadDetails
Downloaded file/folder from shared link.
shared_link_owner UserLogInfo? Shared link owner details. Might be missing due to historical data gap. This field is optional.
UserLogInfo (datatype with subtypes)
User's logged information. This datatype will be one of the following subtypes:
team_member TeamMemberLogInfo
TeamMemberLogInfo
Team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
team_member_id String? Team member ID. Might be missing due to historical data gap. This field is optional.
member_external_id String(max_length=64)? Team member external ID. This field is optional.
non_team_member NonTeamMemberLogInfo
NonTeamMemberLogInfo
Non team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
shared_link_remove_expiry_details SharedLinkRemoveExpiryDetails
SharedLinkRemoveExpiryDetails
Removed shared link expiration date.
previous_value Timestamp(format="%Y-%m-%dT%H:%M:%SZ")? Previous shared link expiration date. Might be missing due to historical data gap. This field is optional.
shared_link_share_details SharedLinkShareDetails
SharedLinkShareDetails
Added members as audience of shared link.
shared_link_owner UserLogInfo? Shared link owner details. Might be missing due to historical data gap. This field is optional.
UserLogInfo (datatype with subtypes)
User's logged information. This datatype will be one of the following subtypes:
team_member TeamMemberLogInfo
TeamMemberLogInfo
Team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
team_member_id String? Team member ID. Might be missing due to historical data gap. This field is optional.
member_external_id String(max_length=64)? Team member external ID. This field is optional.
non_team_member NonTeamMemberLogInfo
NonTeamMemberLogInfo
Non team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
external_users List of (ExternalUserLogInfo)? Users without a Dropbox account that were added as shared link audience. This field is optional.
ExternalUserLogInfo
A user without a Dropbox account.
user_identifier String An external user identifier.
identifier_type IdentifierType Identifier type.
IdentifierType (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
email Void
facebook_profile_name Void
shared_link_view_details SharedLinkViewDetails
SharedLinkViewDetails
Opened shared link.
shared_link_owner UserLogInfo? Shared link owner details. Might be missing due to historical data gap. This field is optional.
UserLogInfo (datatype with subtypes)
User's logged information. This datatype will be one of the following subtypes:
team_member TeamMemberLogInfo
TeamMemberLogInfo
Team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
team_member_id String? Team member ID. Might be missing due to historical data gap. This field is optional.
member_external_id String(max_length=64)? Team member external ID. This field is optional.
non_team_member NonTeamMemberLogInfo
NonTeamMemberLogInfo
Non team member's logged information.
account_id String(min_length=40, max_length=40)? User unique ID. Might be missing due to historical data gap. This field is optional.
display_name String? User display name. Might be missing due to historical data gap. This field is optional.
email String(max_length=255)? User email address. Might be missing due to historical data gap. This field is optional.
shared_note_opened_details SharedNoteOpenedDetails
SharedNoteOpenedDetails
Opened shared Paper doc.
shmodel_group_share_details ShmodelGroupShareDetails
ShmodelGroupShareDetails
Shared link with group.
showcase_access_granted_details ShowcaseAccessGrantedDetails
ShowcaseAccessGrantedDetails
Granted access to showcase.
event_uuid String Event unique identifier.
showcase_add_member_details ShowcaseAddMemberDetails
ShowcaseAddMemberDetails
Added member to showcase.
event_uuid String Event unique identifier.
showcase_archived_details ShowcaseArchivedDetails
ShowcaseArchivedDetails
Archived showcase.
event_uuid String Event unique identifier.
showcase_created_details ShowcaseCreatedDetails
ShowcaseCreatedDetails
Created showcase.
event_uuid String Event unique identifier.
showcase_delete_comment_details ShowcaseDeleteCommentDetails
ShowcaseDeleteCommentDetails
Deleted showcase comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. This field is optional.
showcase_edited_details ShowcaseEditedDetails
ShowcaseEditedDetails
Edited showcase.
event_uuid String Event unique identifier.
showcase_edit_comment_details ShowcaseEditCommentDetails
ShowcaseEditCommentDetails
Edited showcase comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. This field is optional.
showcase_file_added_details ShowcaseFileAddedDetails
ShowcaseFileAddedDetails
Added file to showcase.
event_uuid String Event unique identifier.
showcase_file_download_details ShowcaseFileDownloadDetails
ShowcaseFileDownloadDetails
Downloaded file from showcase.
event_uuid String Event unique identifier.
download_type String Showcase download type.
showcase_file_removed_details ShowcaseFileRemovedDetails
ShowcaseFileRemovedDetails
Removed file from showcase.
event_uuid String Event unique identifier.
showcase_file_view_details ShowcaseFileViewDetails
ShowcaseFileViewDetails
Viewed file in showcase.
event_uuid String Event unique identifier.
showcase_permanently_deleted_details ShowcasePermanentlyDeletedDetails
ShowcasePermanentlyDeletedDetails
Permanently deleted showcase.
event_uuid String Event unique identifier.
showcase_post_comment_details ShowcasePostCommentDetails
ShowcasePostCommentDetails
Added showcase comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. This field is optional.
showcase_remove_member_details ShowcaseRemoveMemberDetails
ShowcaseRemoveMemberDetails
Removed member from showcase.
event_uuid String Event unique identifier.
showcase_renamed_details ShowcaseRenamedDetails
ShowcaseRenamedDetails
Renamed showcase.
event_uuid String Event unique identifier.
showcase_request_access_details ShowcaseRequestAccessDetails
ShowcaseRequestAccessDetails
Requested access to showcase.
event_uuid String Event unique identifier.
showcase_resolve_comment_details ShowcaseResolveCommentDetails
ShowcaseResolveCommentDetails
Resolved showcase comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. This field is optional.
showcase_restored_details ShowcaseRestoredDetails
ShowcaseRestoredDetails
Unarchived showcase.
event_uuid String Event unique identifier.
showcase_trashed_details ShowcaseTrashedDetails
ShowcaseTrashedDetails
Deleted showcase.
event_uuid String Event unique identifier.
showcase_trashed_deprecated_details ShowcaseTrashedDeprecatedDetails
ShowcaseTrashedDeprecatedDetails
Deleted showcase (old version).
event_uuid String Event unique identifier.
showcase_unresolve_comment_details ShowcaseUnresolveCommentDetails
ShowcaseUnresolveCommentDetails
Unresolved showcase comment.
event_uuid String Event unique identifier.
comment_text String? Comment text. This field is optional.
showcase_untrashed_details ShowcaseUntrashedDetails
ShowcaseUntrashedDetails
Restored showcase.
event_uuid String Event unique identifier.
showcase_untrashed_deprecated_details ShowcaseUntrashedDeprecatedDetails
ShowcaseUntrashedDeprecatedDetails
Restored showcase (old version).
event_uuid String Event unique identifier.
showcase_view_details ShowcaseViewDetails
ShowcaseViewDetails
Viewed showcase.
event_uuid String Event unique identifier.
sso_add_cert_details SsoAddCertDetails
SsoAddCertDetails
Added X.509 certificate for SSO.
certificate_details Certificate SSO certificate details.
Certificate
Certificate details.
subject String Certificate subject.
issuer String Certificate issuer.
issue_date String Certificate issue date.
expiration_date String Certificate expiration date.
serial_number String Certificate serial number.
sha1_fingerprint String Certificate sha1 fingerprint.
common_name String? Certificate common name. This field is optional.
sso_add_login_url_details SsoAddLoginUrlDetails
SsoAddLoginUrlDetails
Added sign-in URL for SSO.
new_value String New single sign-on login URL.
sso_add_logout_url_details SsoAddLogoutUrlDetails
SsoAddLogoutUrlDetails
Added sign-out URL for SSO.
new_value String? New single sign-on logout URL. Might be missing due to historical data gap. This field is optional.
sso_change_cert_details SsoChangeCertDetails
SsoChangeCertDetails
Changed X.509 certificate for SSO.
new_certificate_details Certificate New SSO certificate details.
Certificate
Certificate details.
subject String Certificate subject.
issuer String Certificate issuer.
issue_date String Certificate issue date.
expiration_date String Certificate expiration date.
serial_number String Certificate serial number.
sha1_fingerprint String Certificate sha1 fingerprint.
common_name String? Certificate common name. This field is optional.
previous_certificate_details Certificate? Previous SSO certificate details. Might be missing due to historical data gap. This field is optional.
Certificate
Certificate details.
subject String Certificate subject.
issuer String Certificate issuer.
issue_date String Certificate issue date.
expiration_date String Certificate expiration date.
serial_number String Certificate serial number.
sha1_fingerprint String Certificate sha1 fingerprint.
common_name String? Certificate common name. This field is optional.
sso_change_login_url_details SsoChangeLoginUrlDetails
SsoChangeLoginUrlDetails
Changed sign-in URL for SSO.
previous_value String Previous single sign-on login URL.
new_value String New single sign-on login URL.
sso_change_logout_url_details SsoChangeLogoutUrlDetails
SsoChangeLogoutUrlDetails
Changed sign-out URL for SSO.
previous_value String? Previous single sign-on logout URL. Might be missing due to historical data gap. This field is optional.
new_value String? New single sign-on logout URL. Might be missing due to historical data gap. This field is optional.
sso_change_saml_identity_mode_details SsoChangeSamlIdentityModeDetails
SsoChangeSamlIdentityModeDetails
Changed SAML identity mode for SSO.
previous_value Int64 Previous single sign-on identity mode.
new_value Int64 New single sign-on identity mode.
sso_remove_cert_details SsoRemoveCertDetails
SsoRemoveCertDetails
Removed X.509 certificate for SSO.
sso_remove_login_url_details SsoRemoveLoginUrlDetails
SsoRemoveLoginUrlDetails
Removed sign-in URL for SSO.
previous_value String Previous single sign-on login URL.
sso_remove_logout_url_details SsoRemoveLogoutUrlDetails
SsoRemoveLogoutUrlDetails
Removed sign-out URL for SSO.
previous_value String Previous single sign-on logout URL.
team_folder_change_status_details TeamFolderChangeStatusDetails
TeamFolderChangeStatusDetails
Changed archival status of team folder.
new_value TeamFolderStatus New team folder status.
TeamFolderStatus (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
previous_value TeamFolderStatus? Previous team folder status. Might be missing due to historical data gap. This field is optional.
TeamFolderStatus (open union)
This datatype comes from an imported namespace originally defined in the team namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
active Void The team folder and sub-folders are available to all members.
archived Void The team folder is not accessible outside of the team folder manager.
archive_in_progress Void The team folder is not accessible outside of the team folder manager.
team_folder_create_details TeamFolderCreateDetails
TeamFolderCreateDetails
Created team folder in active status.
team_folder_downgrade_details TeamFolderDowngradeDetails
TeamFolderDowngradeDetails
Downgraded team folder to regular shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
team_folder_permanently_delete_details TeamFolderPermanentlyDeleteDetails
TeamFolderPermanentlyDeleteDetails
Permanently deleted archived team folder.
team_folder_rename_details TeamFolderRenameDetails
TeamFolderRenameDetails
Renamed active/archived team folder.
previous_folder_name String Previous folder name.
new_folder_name String New folder name.
team_selective_sync_settings_changed_details TeamSelectiveSyncSettingsChangedDetails
TeamSelectiveSyncSettingsChangedDetails
Changed sync default.
previous_value SyncSetting Previous value.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
new_value SyncSetting New value.
SyncSetting (open union)
This datatype comes from an imported namespace originally defined in the files namespace. The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void On first sync to members' computers, the specified folder will follow its parent folder's setting or otherwise follow default sync behavior.
not_synced Void On first sync to members' computers, the specified folder will be set to not sync with selective sync.
not_synced_inactive Void The specified folder's not_synced setting is inactive due to its location or other configuration changes. It will follow its parent folder's setting.
account_capture_change_policy_details AccountCaptureChangePolicyDetails
AccountCaptureChangePolicyDetails
Changed account capture setting on team domain.
new_value AccountCapturePolicy New account capture policy.
AccountCapturePolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
invited_users Void
all_users Void
previous_value AccountCapturePolicy? Previous account capture policy. Might be missing due to historical data gap. This field is optional.
AccountCapturePolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
invited_users Void
all_users Void
allow_download_disabled_details AllowDownloadDisabledDetails
AllowDownloadDisabledDetails
Disabled downloads.
allow_download_enabled_details AllowDownloadEnabledDetails
AllowDownloadEnabledDetails
Enabled downloads.
data_placement_restriction_change_policy_details DataPlacementRestrictionChangePolicyDetails
DataPlacementRestrictionChangePolicyDetails
Set restrictions on data center locations where team data resides.
previous_value PlacementRestriction Previous placement restriction.
PlacementRestriction (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
europe_only Void
none Void
new_value