Dropbox for HTTP Developers

file_properties

team

team_log

deprecated

Note: The API v2 version of team_log/get_events is available in preview for the Dropbox Business endpoints with a planned GA release in January, 2018.

Developers are encouraged to begin using this endpoint for apps that will be production ready after January, 2018. Current production apps should continue to use the API v1 log/get_events endpoint until the v2 team_log/get_events is released, after which they will have a six month period to migrate.

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. 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.

Therefore Dropbox-API-Select-Admin header is particularly useful for accessing content that might not exist in any team member's Dropbox. An example of this is a shared folder that has been deleted from the Dropbox accounts of all team members that have access to it. Another example is a team folder that has no groups associated with it.

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.

For example, let's say your app is trying to retrieve metadata associated with cupcake.png in the shared folder Images with shared_folder_id 123456. Let's imagine Dan, the designer, is a collaborator on Images and has added this shared folder to their Dropbox, mounting it inside top-level folder Design (/Design/Images). The traditional method for an app with team member file access to retrieve metadata for cupcake.png would be to call files/get_metadata while impersonating Dan by his member_id and passing in the logical path /Design/Images/cupcake.png. However, the traditional method would fail if Dan were to remove Images from his Dropbox. Calling files/get_metadata while impersonating a team admin with the Dropbox-API-Select-Admin header, and passing in the namespace-relative path, ns:123456/cupcake.png would circumvent this issue, even if that team admin is not a member of Images.

While a namespace-relative path can be used with the Dropbox-API-Select-User header, the shared or team folder it specifies must be mounted in the Dropbox of the team member "selected" by the header.

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

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 template/*_for_user endpoints, while team-owned templates are accessed via the team-auth template/*_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

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

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

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

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

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

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

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

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

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
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
RevokeDeviceSessionBatchError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.

/features/get_values

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 Dropbox for Business account 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 have a company shared dropbox.
has_team_file_events Void Does this team have file events.
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 for 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 team shared dropbox.
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.
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

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

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.
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.
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

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

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.
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.
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

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

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 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

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

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.
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.
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

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 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.
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.
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

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.
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.
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

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.
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.
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

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.
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.
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

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.
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.
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

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

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

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

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
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
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

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

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 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.
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.
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

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.
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.
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

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

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? 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

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

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
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? 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

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.
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.
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.
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

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.
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.
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

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.
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.
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
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
MembersGetInfoError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.

/members/list

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 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.
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.
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
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
MembersListError (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.

/members/list/continue

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.
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.
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/recover

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

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.
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: remove_last_admin
{
    "error_summary": "remove_last_admin/...",
    "error": {
        ".tag": "remove_last_admin"
    }
}
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_found
{
    "error_summary": "transfer_admin_user_not_found/...",
    "error": {
        ".tag": "transfer_admin_user_not_found"
    }
}
Example: transfer_admin_user_not_in_team
{
    "error_summary": "transfer_admin_user_not_in_team/...",
    "error": {
        ".tag": "transfer_admin_user_not_in_team"
    }
}
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: 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"
    }
}
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.
remove_last_admin Void The user is the last admin of the team, so it cannot be removed from it.
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_found Void No matching user found for the argument transfer_admin_id.
transfer_admin_user_not_in_team Void The provided transfer_admin_id does not exist on this team.
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.
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.

/members/remove/job_status/get

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

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

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

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.
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.
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.
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: 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.

/members/suspend

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
Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
user UserSelectorArg Identity of user to remove/suspend.
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

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

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 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 folder, the ID of the 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

No errors.

/namespaces/list/continue

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 folder, the ID of the 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_cursor
{
    "error_summary": "invalid_cursor/...",
    "error": {
        ".tag": "invalid_cursor"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
TeamNamespacesListContinueError (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.

/reports/get_activity

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
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
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

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
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
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

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
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
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

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
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
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

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
}
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 the team shared dropbox.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
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 team shared dropbox.

/team_folder/archive

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
}
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 the team shared dropbox.
Errors
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
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 team shared dropbox.

/team_folder/archive/check

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
}
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 the team shared dropbox.
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 team shared dropbox.
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

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\"}"
Parameters
{
    "name": "Marketing"
}
TeamFolderCreateArg
name String Name for the new team folder.
Returns
{
    "team_folder_id": "123456789",
    "name": "Marketing",
    "status": {
        ".tag": "active"
    },
    "is_team_shared_dropbox": false
}
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 the team shared dropbox.
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.

/team_folder/get_info

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 the team shared dropbox.
Errors

No errors.

/team_folder/list

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 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
        }
    ],
    "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 the team shared dropbox.
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

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
        }
    ],
    "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 the team shared dropbox.
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

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
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
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 team shared dropbox.

/team_folder/rename

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
}
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 the team shared dropbox.
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 team shared dropbox.
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.

/token/get_authenticated_admin

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.
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.
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

PREVIEW - may change or disappear without notice
Description

Retrieves team events.
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 Number of results to return per call. 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.
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"
            },
            "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"
                }
            },
            "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"
            },
            "event_type": {
                ".tag": "shared_content_download",
                "description": "(sharing) Downloaded the shared file or folder."
            },
            "details": {
                ".tag": "shared_content_download_details",
                "shared_content_link": "abc",
                "target_asset_index": 3,
                "sharing_permission": "abc"
            },
            "origin": {
                "access_method": {
                    ".tag": "end_user",
                    "end_user": {
                        ".tag": "web",
                        "session_id": "dbwsid:123456789012345678901234567890123456789"
                    }
                },
                "geo_location": {
                    "ip_address": "10.1.1.100",
                    "city": "San Francisco",
                    "region": "California",
                    "country": "US"
                }
            },
            "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.
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.
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.
actor ActorLogInfo The entity who actually performed the action.
ActorLogInfo (open union)
The entity who performed the action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user UserLogInfo The user who did the action.
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(min_length=1)? 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(min_length=1)? 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.
admin UserLogInfo The admin who did the action.
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(min_length=1)? 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(min_length=1)? 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.
app AppLogInfo The application who did the action.
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.
reseller ResellerLogInfo Action done by reseller.
ResellerLogInfo
Reseller information.
reseller_name String Reseller name.
reseller_email String(max_length=255) Reseller email.
dropbox Void Action done by Dropbox.
anonymous Void Anonymous actor.
involve_non_team_member Boolean True if the action involved a non team member either as the actor or as one of the affected users.
context ContextLogInfo The user or team on whose behalf the actor performed the action.
ContextLogInfo (open union)
The primary entity on which the action was done. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team_member TeamMemberLogInfo Action was done on behalf of a team member.
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(min_length=1)? 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 Action was done on behalf of a non team member.
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(min_length=1)? 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.
anonymous Void Anonymous context.
team Void Action was done on behalf of the team.
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 an app for team.
AppLinkTeamType
description String
app_link_user AppLinkUserType (apps) Linked an app for team member.
AppLinkUserType
description String
app_unlink_team AppUnlinkTeamType (apps) Unlinked an app for team.
AppUnlinkTeamType
description String
app_unlink_user AppUnlinkUserType (apps) Unlinked an app for team member.
AppUnlinkUserType
description String
file_add_comment FileAddCommentType (comments) Added a 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 a file comment.
FileDeleteCommentType
description String
file_like_comment FileLikeCommentType (comments) Liked a file comment. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
FileLikeCommentType
description String
file_resolve_comment FileResolveCommentType (comments) Resolved a file comment.
FileResolveCommentType
description String
file_unlike_comment FileUnlikeCommentType (comments) Unliked a file comment. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
FileUnlikeCommentType
description String
file_unresolve_comment FileUnresolveCommentType (comments) Unresolved a file comment.
FileUnresolveCommentType
description String
device_change_ip_desktop DeviceChangeIpDesktopType (devices) IP address associated with active desktop session changed.
DeviceChangeIpDesktopType
description String
device_change_ip_mobile DeviceChangeIpMobileType (devices) IP address associated with active mobile session changed.
DeviceChangeIpMobileType
description String
device_change_ip_web DeviceChangeIpWebType (devices) IP address associated with active Web session changed.
DeviceChangeIpWebType
description String
device_delete_on_unlink_fail DeviceDeleteOnUnlinkFailType (devices) Failed to delete all files from an unlinked device.
DeviceDeleteOnUnlinkFailType
description String
device_delete_on_unlink_success DeviceDeleteOnUnlinkSuccessType (devices) Deleted all files from an unlinked device.
DeviceDeleteOnUnlinkSuccessType
description String
device_link_fail DeviceLinkFailType (devices) Failed to link a device.
DeviceLinkFailType
description String
device_link_success DeviceLinkSuccessType (devices) Linked a device.
DeviceLinkSuccessType
description String
device_management_disabled DeviceManagementDisabledType (devices) Disable Device Management. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DeviceManagementDisabledType
description String
device_management_enabled DeviceManagementEnabledType (devices) Enable Device Management. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DeviceManagementEnabledType
description String
device_unlink DeviceUnlinkType (devices) Disconnected a device.
DeviceUnlinkType
description String
emm_refresh_auth_token EmmRefreshAuthTokenType (devices) Refreshed the auth token used for setting up enterprise mobility management.
EmmRefreshAuthTokenType
description String
account_capture_change_availability AccountCaptureChangeAvailabilityType (domains) Granted or revoked the option to enable account capture on domains belonging to the team.
AccountCaptureChangeAvailabilityType
description String
account_capture_migrate_account AccountCaptureMigrateAccountType (domains) Account captured user migrated their account to the team.
AccountCaptureMigrateAccountType
description String
account_capture_relinquish_account AccountCaptureRelinquishAccountType (domains) Account captured user relinquished their account by changing the email address associated with it.
AccountCaptureRelinquishAccountType
description String
disabled_domain_invites DisabledDomainInvitesType (domains) Disabled domain invites. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DisabledDomainInvitesType
description String
domain_invites_approve_request_to_join_team DomainInvitesApproveRequestToJoinTeamType (domains) Approved a member's request to join the team.
DomainInvitesApproveRequestToJoinTeamType
description String
domain_invites_decline_request_to_join_team DomainInvitesDeclineRequestToJoinTeamType (domains) Declined a user's request to join the team.
DomainInvitesDeclineRequestToJoinTeamType
description String
domain_invites_email_existing_users DomainInvitesEmailExistingUsersType (domains) Sent domain invites to existing domain accounts.
DomainInvitesEmailExistingUsersType
description String
domain_invites_request_to_join_team DomainInvitesRequestToJoinTeamType (domains) Asked to join the team.
DomainInvitesRequestToJoinTeamType
description String
domain_invites_set_invite_new_user_pref_to_no DomainInvitesSetInviteNewUserPrefToNoType (domains) Turned off u201cAutomatically invite new usersu201d. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DomainInvitesSetInviteNewUserPrefToNoType
description String
domain_invites_set_invite_new_user_pref_to_yes DomainInvitesSetInviteNewUserPrefToYesType (domains) Turned on u201cAutomatically invite new usersu201d. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DomainInvitesSetInviteNewUserPrefToYesType
description String
domain_verification_add_domain_fail DomainVerificationAddDomainFailType (domains) Failed to verify a domain belonging to the team.
DomainVerificationAddDomainFailType
description String
domain_verification_add_domain_success DomainVerificationAddDomainSuccessType (domains) Verified a domain belonging to the team.
DomainVerificationAddDomainSuccessType
description String
domain_verification_remove_domain DomainVerificationRemoveDomainType (domains) Removed a domain from the list of verified domains belonging to the team.
DomainVerificationRemoveDomainType
description String
enabled_domain_invites EnabledDomainInvitesType (domains) Enabled domain invites. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
EnabledDomainInvitesType
description String
create_folder CreateFolderType (file_operations) Created folders. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
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) Create a copy reference to a file or 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 a previous version.
FileRevertType
description String
file_rollback_changes FileRollbackChangesType (file_operations) Rolled back file change location changes.
FileRollbackChangesType
description String
file_save_copy_reference FileSaveCopyReferenceType (file_operations) Save a file or folder using a copy reference.
FileSaveCopyReferenceType
description String
file_request_add_deadline FileRequestAddDeadlineType (file_requests) Added a deadline to a file request. This event is replaced by file_request_change and will not be logged going forward.
FileRequestAddDeadlineType
description String
file_request_change FileRequestChangeType (file_requests) Change a file request.
FileRequestChangeType
description String
file_request_change_folder FileRequestChangeFolderType (file_requests) Changed the file request folder. This event is replaced by file_request_change and will not be logged going forward.
FileRequestChangeFolderType
description String
file_request_close FileRequestCloseType (file_requests) Closed a file request.
FileRequestCloseType
description String
file_request_create FileRequestCreateType (file_requests) Created a file request.
FileRequestCreateType
description String
file_request_receive_file FileRequestReceiveFileType (file_requests) Received files for a file request.
FileRequestReceiveFileType
description String
file_request_remove_deadline FileRequestRemoveDeadlineType (file_requests) Removed the file request deadline. This event is replaced by file_request_change and will not be logged going forward.
FileRequestRemoveDeadlineType
description String
file_request_send FileRequestSendType (file_requests) Sent file request to users via email. This event is replaced by file_request_change and will not be logged going forward.
FileRequestSendType
description String
group_add_external_id GroupAddExternalIdType (groups) Added an external ID for group.
GroupAddExternalIdType
description String
group_add_member GroupAddMemberType (groups) Added team members to a group.
GroupAddMemberType
description String
group_change_external_id GroupChangeExternalIdType (groups) Changed the 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 the manager permissions belonging to a group member.
GroupChangeMemberRoleType
description String
group_create GroupCreateType (groups) Created a group.
GroupCreateType
description String
group_delete GroupDeleteType (groups) Deleted a group.
GroupDeleteType
description String
group_moved GroupMovedType (groups) Moved a group. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
GroupMovedType
description String
group_remove_external_id GroupRemoveExternalIdType (groups) Removed the external ID for group.
GroupRemoveExternalIdType
description String
group_remove_member GroupRemoveMemberType (groups) Removed team members from a group.
GroupRemoveMemberType
description String
group_rename GroupRenameType (groups) Renamed a group.
GroupRenameType
description String
emm_error EmmErrorType (logins) Failed to sign in via EMM. This event is replaced by login_fail and will not be logged going forward.
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. This event is replaced by login_fail and will not be logged going forward.
SsoErrorType
description String
member_change_admin_role MemberChangeAdminRoleType (members) Change the admin role belonging to team member.
MemberChangeAdminRoleType
description String
member_change_email MemberChangeEmailType (members) Changed team member email address.
MemberChangeEmailType
description String
member_change_membership_type MemberChangeMembershipTypeType (members) Changed the membership type (limited vs full) for team member. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
MemberChangeMembershipTypeType
description String
member_change_name MemberChangeNameType (members) Changed team member name.
MemberChangeNameType
description String
member_change_status MemberChangeStatusType (members) Changed the membership status of a team member.
MemberChangeStatusType
description String
member_permanently_delete_account_contents MemberPermanentlyDeleteAccountContentsType (members) Permanently deleted contents of a removed team member account.
MemberPermanentlyDeleteAccountContentsType
description String
member_space_limits_change_status MemberSpaceLimitsChangeStatusType (members) Changed the status with respect to whether the team member is under or over storage quota specified by policy.
MemberSpaceLimitsChangeStatusType
description String
member_suggest MemberSuggestType (members) Suggested a new team member to be added to the team.
MemberSuggestType
description String
member_transfer_account_contents MemberTransferAccountContentsType (members) Transferred contents of a removed team member account to another member.
MemberTransferAccountContentsType
description String
paper_content_add_member PaperContentAddMemberType (paper) Added users to the membership of a Paper doc or folder.
PaperContentAddMemberType
description String
paper_content_add_to_folder PaperContentAddToFolderType (paper) Added Paper doc or folder to a folder.
PaperContentAddToFolderType
description String
paper_content_archive PaperContentArchiveType (paper) Archived Paper doc or folder.
PaperContentArchiveType
description String
paper_content_create PaperContentCreateType (paper) Created a Paper doc or folder.
PaperContentCreateType
description String
paper_content_permanently_delete PaperContentPermanentlyDeleteType (paper) Permanently deleted a Paper doc or folder.
PaperContentPermanentlyDeleteType
description String
paper_content_remove_from_folder PaperContentRemoveFromFolderType (paper) Removed Paper doc or folder from a folder.
PaperContentRemoveFromFolderType
description String
paper_content_remove_member PaperContentRemoveMemberType (paper) Removed a user from the membership of a Paper doc or folder.
PaperContentRemoveMemberType
description String
paper_content_rename PaperContentRenameType (paper) Renamed Paper doc or folder.
PaperContentRenameType
description String
paper_content_restore PaperContentRestoreType (paper) Restored an archived Paper doc or folder.
PaperContentRestoreType
description String
paper_doc_add_comment PaperDocAddCommentType (paper) Added a Paper doc comment.
PaperDocAddCommentType
description String
paper_doc_change_member_role PaperDocChangeMemberRoleType (paper) Changed the access type of a Paper doc member.
PaperDocChangeMemberRoleType
description String
paper_doc_change_sharing_policy PaperDocChangeSharingPolicyType (paper) Changed the sharing policy for Paper doc.
PaperDocChangeSharingPolicyType
description String
paper_doc_change_subscription PaperDocChangeSubscriptionType (paper) Followed or unfollowed a Paper doc.
PaperDocChangeSubscriptionType
description String
paper_doc_deleted PaperDocDeletedType (paper) Paper doc archived. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
PaperDocDeletedType
description String
paper_doc_delete_comment PaperDocDeleteCommentType (paper) Deleted a Paper doc comment.
PaperDocDeleteCommentType
description String
paper_doc_download PaperDocDownloadType (paper) Downloaded a Paper doc in a particular output format.
PaperDocDownloadType
description String
paper_doc_edit PaperDocEditType (paper) Edited a Paper doc.
PaperDocEditType
description String
paper_doc_edit_comment PaperDocEditCommentType (paper) Edited a Paper doc comment.
PaperDocEditCommentType
description String
paper_doc_followed PaperDocFollowedType (paper) Followed a Paper doc. This event is replaced by paper_doc_change_subscription and will not be logged going forward.
PaperDocFollowedType
description String
paper_doc_mention PaperDocMentionType (paper) Mentioned a member in a Paper doc.
PaperDocMentionType
description String
paper_doc_request_access PaperDocRequestAccessType (paper) Requested to be a member on a Paper doc.
PaperDocRequestAccessType
description String
paper_doc_resolve_comment PaperDocResolveCommentType (paper) Paper doc comment resolved.
PaperDocResolveCommentType
description String
paper_doc_revert PaperDocRevertType (paper) Restored a Paper doc to previous revision.
PaperDocRevertType
description String
paper_doc_slack_share PaperDocSlackShareType (paper) Paper doc link shared via slack.
PaperDocSlackShareType
description String
paper_doc_team_invite PaperDocTeamInviteType (paper) Paper doc shared with team member. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
PaperDocTeamInviteType
description String
paper_doc_trashed PaperDocTrashedType (paper) Paper doc trashed.
PaperDocTrashedType
description String
paper_doc_unresolve_comment PaperDocUnresolveCommentType (paper) Unresolved a Paper doc comment.
PaperDocUnresolveCommentType
description String
paper_doc_untrashed PaperDocUntrashedType (paper) Paper doc untrashed.
PaperDocUntrashedType
description String
paper_doc_view PaperDocViewType (paper) Viewed Paper doc.
PaperDocViewType
description String
paper_external_view_allow PaperExternalViewAllowType (paper) Paper external sharing policy changed: anyone. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
PaperExternalViewAllowType
description String
paper_external_view_default_team PaperExternalViewDefaultTeamType (paper) Paper external sharing policy changed: default team. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
PaperExternalViewDefaultTeamType
description String
paper_external_view_forbid PaperExternalViewForbidType (paper) Paper external sharing policy changed: team-only. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
PaperExternalViewForbidType
description String
paper_folder_change_subscription PaperFolderChangeSubscriptionType (paper) Followed or unfollowed a Paper folder.
PaperFolderChangeSubscriptionType
description String
paper_folder_deleted PaperFolderDeletedType (paper) Paper folder archived. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
PaperFolderDeletedType
description String
paper_folder_followed PaperFolderFollowedType (paper) Followed a Paper folder. This event is replaced by paper_folder_change_subscription and will not be logged going forward.
PaperFolderFollowedType
description String
paper_folder_team_invite PaperFolderTeamInviteType (paper) Paper folder shared with team member. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
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) EMM excluded users report created.
EmmCreateExceptionsReportType
description String
emm_create_usage_report EmmCreateUsageReportType (reports) EMM mobile app usage report created.
EmmCreateUsageReportType
description String
paper_admin_export_start PaperAdminExportStartType (reports) Exported all Paper documents in the team.
PaperAdminExportStartType
description String
smart_sync_create_admin_privilege_report SmartSyncCreateAdminPrivilegeReportType (reports) Smart Sync non-admin devices report created.
SmartSyncCreateAdminPrivilegeReportType
description String
team_activity_create_report TeamActivityCreateReportType (reports) Created a team activity report.
TeamActivityCreateReportType
description String
collection_share CollectionShareType (sharing) Shared an album.
CollectionShareType
description String
note_acl_invite_only NoteAclInviteOnlyType (sharing) Changed a Paper document to be invite-only. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
NoteAclInviteOnlyType
description String
note_acl_link NoteAclLinkType (sharing) Changed a Paper document to be link accessible. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
NoteAclLinkType
description String
note_acl_team_link NoteAclTeamLinkType (sharing) Changed a Paper document to be link accessible for the team. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
NoteAclTeamLinkType
description String
note_shared NoteSharedType (sharing) Shared a Paper doc. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
NoteSharedType
description String
note_share_receive NoteShareReceiveType (sharing) Shared Paper document received. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
NoteShareReceiveType
description String
open_note_shared OpenNoteSharedType (sharing) Opened a shared Paper doc. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
OpenNoteSharedType
description String
sf_add_group SfAddGroupType (sharing) Added the team to a shared folder.
SfAddGroupType
description String
sf_allow_non_members_to_view_shared_links SfAllowNonMembersToViewSharedLinksType (sharing) Allowed non collaborators to view links to files in a shared folder. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SfAllowNonMembersToViewSharedLinksType
description String
sf_external_invite_warn SfExternalInviteWarnType (sharing) Admin settings: team members see a warning before sharing folders outside the team (DEPRECATED FEATURE). This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SfExternalInviteWarnType
description String
sf_invite_group SfInviteGroupType (sharing) Invited a group to a shared folder. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SfInviteGroupType
description String
sf_nest SfNestType (sharing) Changed parent of shared folder.
SfNestType
description String
sf_team_decline SfTeamDeclineType (sharing) Declined a team member's invitation to a shared folder.
SfTeamDeclineType
description String
sf_team_grant_access SfTeamGrantAccessType (sharing) Granted access to a shared folder. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SfTeamGrantAccessType
description String
sf_team_invite SfTeamInviteType (sharing) Invited team members to a shared folder. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SfTeamInviteType
description String
sf_team_invite_change_role SfTeamInviteChangeRoleType (sharing) Changed a team member's role in a shared folder. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SfTeamInviteChangeRoleType
description String
sf_team_join SfTeamJoinType (sharing) Joined a team member's shared folder. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SfTeamJoinType
description String
sf_team_join_from_oob_link SfTeamJoinFromOobLinkType (sharing) Joined a team member's shared folder from a link. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SfTeamJoinFromOobLinkType
description String
sf_team_uninvite SfTeamUninviteType (sharing) Unshared a folder with a team member. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SfTeamUninviteType
description String
shared_content_add_invitees SharedContentAddInviteesType (sharing) Sent an email invitation to the membership of a shared file or folder.
SharedContentAddInviteesType
description String
shared_content_add_link_expiry SharedContentAddLinkExpiryType (sharing) Added an expiry to the link for the shared file or folder.
SharedContentAddLinkExpiryType
description String
shared_content_add_link_password SharedContentAddLinkPasswordType (sharing) Added a password to the link for the shared file or folder.
SharedContentAddLinkPasswordType
description String
shared_content_add_member SharedContentAddMemberType (sharing) Added users and/or groups to the membership of a shared file or folder.
SharedContentAddMemberType
description String
shared_content_change_downloads_policy SharedContentChangeDownloadsPolicyType (sharing) Changed whether members can download the shared file or folder.
SharedContentChangeDownloadsPolicyType
description String
shared_content_change_invitee_role SharedContentChangeInviteeRoleType (sharing) Changed the access type of an invitee to a shared file or folder before the invitation was claimed.
SharedContentChangeInviteeRoleType
description String
shared_content_change_link_audience SharedContentChangeLinkAudienceType (sharing) Changed the audience of the link for a shared file or folder.
SharedContentChangeLinkAudienceType
description String
shared_content_change_link_expiry SharedContentChangeLinkExpiryType (sharing) Changed the expiry of the link for the shared file or folder.
SharedContentChangeLinkExpiryType
description String
shared_content_change_link_password SharedContentChangeLinkPasswordType (sharing) Changed the password on the link for the shared file or folder.
SharedContentChangeLinkPasswordType
description String
shared_content_change_member_role SharedContentChangeMemberRoleType (sharing) Changed the access type of a shared file or folder member.
SharedContentChangeMemberRoleType
description String
shared_content_change_viewer_info_policy SharedContentChangeViewerInfoPolicyType (sharing) Changed whether members can see who viewed the shared file or folder.
SharedContentChangeViewerInfoPolicyType
description String
shared_content_claim_invitation SharedContentClaimInvitationType (sharing) Claimed membership to a team member's shared folder.
SharedContentClaimInvitationType
description String
shared_content_copy SharedContentCopyType (sharing) Copied the shared file or folder to own Dropbox.
SharedContentCopyType
description String
shared_content_download SharedContentDownloadType (sharing) Downloaded the shared file or folder.
SharedContentDownloadType
description String
shared_content_relinquish_membership SharedContentRelinquishMembershipType (sharing) Left the membership of a shared file or folder.
SharedContentRelinquishMembershipType
description String
shared_content_remove_invitee SharedContentRemoveInviteeType (sharing) Removed an invitee from the membership of a shared file or folder before it was claimed.
SharedContentRemoveInviteeType
description String
shared_content_remove_link_expiry SharedContentRemoveLinkExpiryType (sharing) Removed the expiry of the link for the shared file or folder.
SharedContentRemoveLinkExpiryType
description String
shared_content_remove_link_password SharedContentRemoveLinkPasswordType (sharing) Removed the password on the link for the shared file or folder.
SharedContentRemoveLinkPasswordType
description String
shared_content_remove_member SharedContentRemoveMemberType (sharing) Removed a user or a group from the membership of a shared file or folder.
SharedContentRemoveMemberType
description String
shared_content_request_access SharedContentRequestAccessType (sharing) Requested to be on the membership of a shared file or folder.
SharedContentRequestAccessType
description String
shared_content_unshare SharedContentUnshareType (sharing) Unshared a shared file or folder by clearing its membership and turning off its link.
SharedContentUnshareType
description String
shared_content_view SharedContentViewType (sharing) Previewed the shared file or folder.
SharedContentViewType
description String
shared_folder_change_confidentiality SharedFolderChangeConfidentialityType (sharing) Set or unset the confidential flag on a shared folder.
SharedFolderChangeConfidentialityType
description String
shared_folder_change_link_policy SharedFolderChangeLinkPolicyType (sharing) Changed who can access the shared folder via a link.
SharedFolderChangeLinkPolicyType
description String
shared_folder_change_member_management_policy SharedFolderChangeMemberManagementPolicyType (sharing) Changed who can manage the membership of a shared folder.
SharedFolderChangeMemberManagementPolicyType
description String
shared_folder_change_member_policy SharedFolderChangeMemberPolicyType (sharing) Changed who can become a member of the shared folder.
SharedFolderChangeMemberPolicyType
description String
shared_folder_create SharedFolderCreateType (sharing) Created a shared folder.
SharedFolderCreateType
description String
shared_folder_mount SharedFolderMountType (sharing) Added a shared folder to own Dropbox.
SharedFolderMountType
description String
shared_folder_transfer_ownership SharedFolderTransferOwnershipType (sharing) Transferred the ownership of a shared folder to another member.
SharedFolderTransferOwnershipType
description String
shared_folder_unmount SharedFolderUnmountType (sharing) Deleted a shared folder from Dropbox.
SharedFolderUnmountType
description String
shared_link_add_expiry SharedLinkAddExpiryType (sharing) Added a shared link expiration date.
SharedLinkAddExpiryType
description String
shared_link_change_expiry SharedLinkChangeExpiryType (sharing) Changed the shared link expiration date.
SharedLinkChangeExpiryType
description String
shared_link_change_visibility SharedLinkChangeVisibilityType (sharing) Changed the visibility of a shared link.
SharedLinkChangeVisibilityType
description String
shared_link_copy SharedLinkCopyType (sharing) Added a file/folder to their Dropbox from a shared link.
SharedLinkCopyType
description String
shared_link_create SharedLinkCreateType (sharing) Created a new shared link.
SharedLinkCreateType
description String
shared_link_disable SharedLinkDisableType (sharing) Removed a shared link.
SharedLinkDisableType
description String
shared_link_download SharedLinkDownloadType (sharing) Downloaded a file/folder from a shared link.
SharedLinkDownloadType
description String
shared_link_remove_expiry SharedLinkRemoveExpiryType (sharing) Removed a shared link expiration date.
SharedLinkRemoveExpiryType
description String
shared_link_share SharedLinkShareType (sharing) Added new members as the audience of a shared link.
SharedLinkShareType
description String
shared_link_view SharedLinkViewType (sharing) Opened a shared link.
SharedLinkViewType
description String
shared_note_opened SharedNoteOpenedType (sharing) Shared Paper document was opened. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
SharedNoteOpenedType
description String
shmodel_group_share ShmodelGroupShareType (sharing) Shared a link with a group. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
ShmodelGroupShareType
description String
sso_add_cert SsoAddCertType (sso) Added the 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 the X.509 certificate for SSO.
SsoChangeCertType
description String
sso_change_login_url SsoChangeLoginUrlType (sso) Changed the sign-in URL for SSO.
SsoChangeLoginUrlType
description String
sso_change_logout_url SsoChangeLogoutUrlType (sso) Changed the sign-out URL for SSO.
SsoChangeLogoutUrlType
description String
sso_change_saml_identity_mode SsoChangeSamlIdentityModeType (sso) Changed the SAML identity mode for SSO.
SsoChangeSamlIdentityModeType
description String
sso_remove_cert SsoRemoveCertType (sso) Removed the X.509 certificate for SSO.
SsoRemoveCertType
description String
sso_remove_login_url SsoRemoveLoginUrlType (sso) Removed the sign-in URL for SSO.
SsoRemoveLoginUrlType
description String
sso_remove_logout_url SsoRemoveLogoutUrlType (sso) Removed single sign-on logout URL.
SsoRemoveLogoutUrlType
description String
team_folder_change_status TeamFolderChangeStatusType (team_folders) Changed the archival status of a team folder.
TeamFolderChangeStatusType
description String
team_folder_create TeamFolderCreateType (team_folders) Created a new team folder in active status.
TeamFolderCreateType
description String
team_folder_downgrade TeamFolderDowngradeType (team_folders) Downgraded a team folder to a regular shared folder.
TeamFolderDowngradeType
description String
team_folder_permanently_delete TeamFolderPermanentlyDeleteType (team_folders) Permanently deleted an archived team folder.
TeamFolderPermanentlyDeleteType
description String
team_folder_rename TeamFolderRenameType (team_folders) Renamed an active or archived team folder.
TeamFolderRenameType
description String
account_capture_change_policy AccountCaptureChangePolicyType (team_policies) Changed the account capture policy on a domain belonging to the team.
AccountCaptureChangePolicyType
description String
allow_download_disabled AllowDownloadDisabledType (team_policies) Disabled allow downloads. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
AllowDownloadDisabledType
description String
allow_download_enabled AllowDownloadEnabledType (team_policies) Enabled allow downloads. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
AllowDownloadEnabledType
description String
data_placement_restriction_change_policy DataPlacementRestrictionChangePolicyType (team_policies) Set a restriction policy regarding the location of data centers where team data resides.
DataPlacementRestrictionChangePolicyType
description String
data_placement_restriction_satisfy_policy DataPlacementRestrictionSatisfyPolicyType (team_policies) Satisfied a previously set restriction policy regarding the location of data centers where team data resides (i.e. all data have been migrated according to the restriction placed).
DataPlacementRestrictionSatisfyPolicyType
description String
device_approvals_change_desktop_policy DeviceApprovalsChangeDesktopPolicyType (team_policies) Set or removed a limit on the number of computers each team member can link to their work Dropbox account.
DeviceApprovalsChangeDesktopPolicyType
description String
device_approvals_change_mobile_policy DeviceApprovalsChangeMobilePolicyType (team_policies) Set or removed a limit on the number of mobiles devices each team member can link to their work Dropbox account.
DeviceApprovalsChangeMobilePolicyType
description String
device_approvals_change_overage_action DeviceApprovalsChangeOverageActionType (team_policies) Changed the action taken when a team member is already over the limits (e.g when they join the team, an admin lowers limits, etc.).
DeviceApprovalsChangeOverageActionType
description String
device_approvals_change_unlink_action DeviceApprovalsChangeUnlinkActionType (team_policies) Changed the action taken with respect to approval limits when a team member unlinks an approved device.
DeviceApprovalsChangeUnlinkActionType
description String
emm_add_exception EmmAddExceptionType (team_policies) Added an exception for one or more team members to optionally use the regular Dropbox app when EMM is enabled.
EmmAddExceptionType
description String
emm_change_policy EmmChangePolicyType (team_policies) Enabled or disabled enterprise mobility management for team members.
EmmChangePolicyType
description String
emm_remove_exception EmmRemoveExceptionType (team_policies) Removed an exception for one or more team members to optionally use the regular Dropbox app when EMM is enabled.
EmmRemoveExceptionType
description String
extended_version_history_change_policy ExtendedVersionHistoryChangePolicyType (team_policies) Accepted or opted out of extended version history.
ExtendedVersionHistoryChangePolicyType
description String
file_comments_change_policy FileCommentsChangePolicyType (team_policies) Enabled or disabled commenting on team files.
FileCommentsChangePolicyType
description String
file_requests_change_policy FileRequestsChangePolicyType (team_policies) Enabled or disabled file requests.
FileRequestsChangePolicyType
description String
file_requests_emails_enabled FileRequestsEmailsEnabledType (team_policies) Enabled file request emails for everyone. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
FileRequestsEmailsEnabledType
description String
file_requests_emails_restricted_to_team_only FileRequestsEmailsRestrictedToTeamOnlyType (team_policies) Allowed file request emails for the team. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
FileRequestsEmailsRestrictedToTeamOnlyType
description String
google_sso_change_policy GoogleSsoChangePolicyType (team_policies) Enabled or disabled Google single sign-on for the 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 the team when not invited.
MemberRequestsChangePolicyType
description String
member_space_limits_add_exception MemberSpaceLimitsAddExceptionType (team_policies) Added an exception for one or more team members to bypass space limits imposed by policy.
MemberSpaceLimitsAddExceptionType
description String
member_space_limits_change_policy MemberSpaceLimitsChangePolicyType (team_policies) Changed the team default limit level.
MemberSpaceLimitsChangePolicyType
description String
member_space_limits_remove_exception MemberSpaceLimitsRemoveExceptionType (team_policies) Removed an exception for one or more team members to bypass space limits imposed by policy.
MemberSpaceLimitsRemoveExceptionType
description String
member_suggestions_change_policy MemberSuggestionsChangePolicyType (team_policies) Enabled or disabled the option for team members to suggest new members to add to the team.
MemberSuggestionsChangePolicyType
description String
microsoft_office_addin_change_policy MicrosoftOfficeAddinChangePolicyType (team_policies) Enabled or disabled the Microsoft Office add-in, which lets team members save files to Dropbox directly from Microsoft Office.
MicrosoftOfficeAddinChangePolicyType
description String
network_control_change_policy NetworkControlChangePolicyType (team_policies) Enabled or disabled network control.
NetworkControlChangePolicyType
description String
paper_change_deployment_policy PaperChangeDeploymentPolicyType (team_policies) Changed whether Dropbox Paper, when enabled, is deployed to all teams or to specific members of the team.
PaperChangeDeploymentPolicyType
description String
paper_change_member_link_policy PaperChangeMemberLinkPolicyType (team_policies) Changed whether non team members can view Paper documents using a link. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
PaperChangeMemberLinkPolicyType
description String
paper_change_member_policy PaperChangeMemberPolicyType (team_policies) Changed whether team members can share Paper documents externally (i.e. outside the team), and if so, whether they should be accessible only by team members or anyone by default.
PaperChangeMemberPolicyType
description String
paper_change_policy PaperChangePolicyType (team_policies) Enabled or disabled Dropbox Paper for the team.
PaperChangePolicyType
description String
paper_enabled_users_group_addition PaperEnabledUsersGroupAdditionType (team_policies) Users added to Paper enabled users list.
PaperEnabledUsersGroupAdditionType
description String
paper_enabled_users_group_removal PaperEnabledUsersGroupRemovalType (team_policies) Users removed from Paper enabled users list.
PaperEnabledUsersGroupRemovalType
description String
permanent_delete_change_policy PermanentDeleteChangePolicyType (team_policies) Enabled or disabled the 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 externally (i.e. outside the team).
SharingChangeFolderJoinPolicyType
description String
sharing_change_link_policy SharingChangeLinkPolicyType (team_policies) Changed whether team members can share links externally (i.e. outside the team), and if so, whether links should be accessible only by team members or anyone by default.
SharingChangeLinkPolicyType
description String
sharing_change_member_policy SharingChangeMemberPolicyType (team_policies) Changed whether team members can share files and folders externally (i.e. outside the team).
SharingChangeMemberPolicyType
description String
smart_sync_change_policy SmartSyncChangePolicyType (team_policies) Changed the default Smart Sync policy 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) Change the single sign-on policy for the team.
SsoChangePolicyType
description String
tfa_change_policy TfaChangePolicyType (team_policies) Change two-step verification policy for the team.
TfaChangePolicyType
description String
two_account_change_policy TwoAccountChangePolicyType (team_policies) Enabled or disabled the option for team members to link a personal Dropbox account in addition to their work account to the same computer.
TwoAccountChangePolicyType
description String
web_sessions_change_fixed_length_policy WebSessionsChangeFixedLengthPolicyType (team_policies) Changed how long team members can stay signed in to Dropbox on the web.
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 on the web.
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 a team logo to be displayed on shared link headers.
TeamProfileAddLogoType
description String
team_profile_change_default_language TeamProfileChangeDefaultLanguageType (team_profile) Changed the default language for the team.
TeamProfileChangeDefaultLanguageType
description String
team_profile_change_logo TeamProfileChangeLogoType (team_profile) Changed the team logo to be displayed on shared link headers.
TeamProfileChangeLogoType
description String
team_profile_change_name TeamProfileChangeNameType (team_profile) Changed the team name.
TeamProfileChangeNameType
description String
team_profile_remove_logo TeamProfileRemoveLogoType (team_profile) Removed the team logo to be displayed on shared link headers.
TeamProfileRemoveLogoType
description String
tfa_add_backup_phone TfaAddBackupPhoneType (tfa) Added a backup phone for two-step verification.
TfaAddBackupPhoneType
description String
tfa_add_security_key TfaAddSecurityKeyType (tfa) Added a security key for two-step verification.
TfaAddSecurityKeyType
description String
tfa_change_backup_phone TfaChangeBackupPhoneType (tfa) Changed the backup phone for two-step verification.
TfaChangeBackupPhoneType
description String
tfa_change_status TfaChangeStatusType (tfa) Enabled, disabled or changed the configuration for two-step verification.
TfaChangeStatusType
description String
tfa_remove_backup_phone TfaRemoveBackupPhoneType (tfa) Removed the backup phone for two-step verification.
TfaRemoveBackupPhoneType
description String
tfa_remove_security_key TfaRemoveSecurityKeyType (tfa) Removed a 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 an 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 an app for team 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 an 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 an app for team 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 a 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 a 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 a 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 a 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 a 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 a 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
IP address associated with active desktop session changed.
device_info DeviceLogInfo Device information.
DeviceLogInfo
Device's logged information.
device_id String? Device unique id. Might be missing due to historical data gap. This field is optional.
display_name String? Device display name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? True if this device is emm managed, false otherwise. Might be missing due to historical data gap. This field is optional.
platform String? Device platform name. Might be missing due to historical data gap. This field is optional.
mac_address String? Device mac address. Might be missing due to historical data gap. This field is optional.
os_version String? Device OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Device type. Might be missing due to historical data gap. This field is optional.
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
last_activity String? Last activity. Might be missing due to historical data gap. This field is optional.
app_version String? Linking app version. Might be missing due to historical data gap. This field is optional.
device_change_ip_mobile_details DeviceChangeIpMobileDetails
DeviceChangeIpMobileDetails
IP address associated with active mobile session changed.
device_info DeviceLogInfo Device information.
DeviceLogInfo
Device's logged information.
device_id String? Device unique id. Might be missing due to historical data gap. This field is optional.
display_name String? Device display name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? True if this device is emm managed, false otherwise. Might be missing due to historical data gap. This field is optional.
platform String? Device platform name. Might be missing due to historical data gap. This field is optional.
mac_address String? Device mac address. Might be missing due to historical data gap. This field is optional.
os_version String? Device OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Device type. Might be missing due to historical data gap. This field is optional.
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
last_activity String? Last activity. Might be missing due to historical data gap. This field is optional.
app_version String? Linking app version. Might be missing due to historical data gap. This field is optional.
device_change_ip_web_details DeviceChangeIpWebDetails
DeviceChangeIpWebDetails
IP address associated with active Web session changed.
user_agent String Web browser name.
device_info DeviceLogInfo? Device information. Might be missing due to historical data gap. This field is optional.
DeviceLogInfo
Device's logged information.
device_id String? Device unique id. Might be missing due to historical data gap. This field is optional.
display_name String? Device display name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? True if this device is emm managed, false otherwise. Might be missing due to historical data gap. This field is optional.
platform String? Device platform name. Might be missing due to historical data gap. This field is optional.
mac_address String? Device mac address. Might be missing due to historical data gap. This field is optional.
os_version String? Device OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Device type. Might be missing due to historical data gap. This field is optional.
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
last_activity String? Last activity. Might be missing due to historical data gap. This field is optional.
app_version String? Linking app version. Might be missing due to historical data gap. This field is optional.
device_delete_on_unlink_fail_details DeviceDeleteOnUnlinkFailDetails
DeviceDeleteOnUnlinkFailDetails
Failed to delete all files from an unlinked device.
device_info DeviceLogInfo Device information.
DeviceLogInfo
Device's logged information.
device_id String? Device unique id. Might be missing due to historical data gap. This field is optional.
display_name String? Device display name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? True if this device is emm managed, false otherwise. Might be missing due to historical data gap. This field is optional.
platform String? Device platform name. Might be missing due to historical data gap. This field is optional.
mac_address String? Device mac address. Might be missing due to historical data gap. This field is optional.
os_version String? Device OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Device type. Might be missing due to historical data gap. This field is optional.
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
last_activity String? Last activity. Might be missing due to historical data gap. This field is optional.
app_version String? Linking app version. Might be missing due to historical data gap. This field is optional.
num_failures Int64 The number of times that remote file deletion failed.
device_delete_on_unlink_success_details DeviceDeleteOnUnlinkSuccessDetails
DeviceDeleteOnUnlinkSuccessDetails
Deleted all files from an unlinked device.
device_info DeviceLogInfo Device information.
DeviceLogInfo
Device's logged information.
device_id String? Device unique id. Might be missing due to historical data gap. This field is optional.
display_name String? Device display name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? True if this device is emm managed, false otherwise. Might be missing due to historical data gap. This field is optional.
platform String? Device platform name. Might be missing due to historical data gap. This field is optional.
mac_address String? Device mac address. Might be missing due to historical data gap. This field is optional.
os_version String? Device OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Device type. Might be missing due to historical data gap. This field is optional.
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
last_activity String? Last activity. Might be missing due to historical data gap. This field is optional.
app_version String? Linking app version. Might be missing due to historical data gap. This field is optional.
device_link_fail_details DeviceLinkFailDetails
DeviceLinkFailDetails
Failed to link a 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
device_info DeviceLogInfo? Device information. Might be missing due to historical data gap. This field is optional.
DeviceLogInfo
Device's logged information.
device_id String? Device unique id. Might be missing due to historical data gap. This field is optional.
display_name String? Device display name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? True if this device is emm managed, false otherwise. Might be missing due to historical data gap. This field is optional.
platform String? Device platform name. Might be missing due to historical data gap. This field is optional.
mac_address String? Device mac address. Might be missing due to historical data gap. This field is optional.
os_version String? Device OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Device type. Might be missing due to historical data gap. This field is optional.
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
last_activity String? Last activity. Might be missing due to historical data gap. This field is optional.
app_version String? Linking app version. Might be missing due to historical data gap. This field is optional.
device_link_success_details DeviceLinkSuccessDetails
DeviceLinkSuccessDetails
Linked a device.
device_info DeviceLogInfo Device information.
DeviceLogInfo
Device's logged information.
device_id String? Device unique id. Might be missing due to historical data gap. This field is optional.
display_name String? Device display name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? True if this device is emm managed, false otherwise. Might be missing due to historical data gap. This field is optional.
platform String? Device platform name. Might be missing due to historical data gap. This field is optional.
mac_address String? Device mac address. Might be missing due to historical data gap. This field is optional.
os_version String? Device OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Device type. Might be missing due to historical data gap. This field is optional.
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
last_activity String? Last activity. Might be missing due to historical data gap. This field is optional.
app_version String? Linking app version. Might be missing due to historical data gap. This field is optional.
device_management_disabled_details DeviceManagementDisabledDetails
DeviceManagementDisabledDetails
Disable Device Management.
device_management_enabled_details DeviceManagementEnabledDetails
DeviceManagementEnabledDetails
Enable Device Management.
device_unlink_details DeviceUnlinkDetails
DeviceUnlinkDetails
Disconnected a device.
device_info DeviceLogInfo Device information.
DeviceLogInfo
Device's logged information.
device_id String? Device unique id. Might be missing due to historical data gap. This field is optional.
display_name String? Device display name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? True if this device is emm managed, false otherwise. Might be missing due to historical data gap. This field is optional.
platform String? Device platform name. Might be missing due to historical data gap. This field is optional.
mac_address String? Device mac address. Might be missing due to historical data gap. This field is optional.
os_version String? Device OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Device type. Might be missing due to historical data gap. This field is optional.
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
last_activity String? Last activity. Might be missing due to historical data gap. This field is optional.
app_version String? Linking app version. Might be missing due to historical data gap. This field is optional.
delete_data Boolean True if the user requested to delete data after device unlink, false otherwise.
emm_refresh_auth_token_details EmmRefreshAuthTokenDetails
EmmRefreshAuthTokenDetails
Refreshed the auth token used for setting up enterprise mobility management.
account_capture_change_availability_details AccountCaptureChangeAvailabilityDetails
AccountCaptureChangeAvailabilityDetails
Granted or revoked the option to enable account capture on domains belonging to the team.
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 their account to the team.
domain_name String Domain name.
account_capture_relinquish_account_details AccountCaptureRelinquishAccountDetails
AccountCaptureRelinquishAccountDetails
Account captured user relinquished their account by changing the email address associated with it.
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 a member's request to join the team.
domain_invites_decline_request_to_join_team_details DomainInvitesDeclineRequestToJoinTeamDetails
DomainInvitesDeclineRequestToJoinTeamDetails
Declined a user's request to join the team.
domain_invites_email_existing_users_details DomainInvitesEmailExistingUsersDetails
DomainInvitesEmailExistingUsersDetails
Sent domain invites to existing domain accounts.
domain_name List of (String) Domain names.
num_recipients UInt64 Number of recipients.
domain_invites_request_to_join_team_details DomainInvitesRequestToJoinTeamDetails
DomainInvitesRequestToJoinTeamDetails
Asked to join the team.
domain_invites_set_invite_new_user_pref_to_no_details DomainInvitesSetInviteNewUserPrefToNoDetails
DomainInvitesSetInviteNewUserPrefToNoDetails
Turned off u201cAutomatically invite new usersu201d.
domain_invites_set_invite_new_user_pref_to_yes_details DomainInvitesSetInviteNewUserPrefToYesDetails
DomainInvitesSetInviteNewUserPrefToYesDetails
Turned on u201cAutomatically invite new usersu201d.
domain_verification_add_domain_fail_details DomainVerificationAddDomainFailDetails
DomainVerificationAddDomainFailDetails
Failed to verify a domain belonging to the team.
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 a domain belonging to the team.
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 a domain from the list of verified domains belonging to the team.
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
Create a copy reference to a file or 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 a previous version.
file_rollback_changes_details FileRollbackChangesDetails
FileRollbackChangesDetails
Rolled back file change location changes.
file_save_copy_reference_details FileSaveCopyReferenceDetails
FileSaveCopyReferenceDetails
Save a file or folder using a 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_add_deadline_details FileRequestAddDeadlineDetails
FileRequestAddDeadlineDetails
Added a deadline to a 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_title String? File request title. This field is optional.
file_request_change_details FileRequestChangeDetails
FileRequestChangeDetails
Change a 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_change_folder_details FileRequestChangeFolderDetails
FileRequestChangeFolderDetails
Changed the file request folder.
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_title String? File request title. This field is optional.
file_request_close_details FileRequestCloseDetails
FileRequestCloseDetails
Closed a 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 a 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 a 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.
request_title String? File request title. This field is optional.
file_request_remove_deadline_details FileRequestRemoveDeadlineDetails
FileRequestRemoveDeadlineDetails
Removed the file request deadline.
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_title String? File request title. This field is optional.
file_request_send_details FileRequestSendDetails
FileRequestSendDetails
Sent file request to users via email.
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_title String? File request title. This field is optional.
group_add_external_id_details GroupAddExternalIdDetails
GroupAddExternalIdDetails
Added an external ID for group.
new_value String Current external id.
group_add_member_details GroupAddMemberDetails
GroupAddMemberDetails
Added team members to a group.
is_group_owner Boolean Is group owner.
group_change_external_id_details GroupChangeExternalIdDetails
GroupChangeExternalIdDetails
Changed the 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 the manager permissions belonging to a group member.
is_group_owner Boolean Is group owner.
group_create_details GroupCreateDetails
GroupCreateDetails
Created a group.
join_policy GroupJoinPolicy Group join policy.
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
is_company_managed Boolean? Is company managed group. Might be missing due to historical data gap. This field is optional.
group_delete_details GroupDeleteDetails
GroupDeleteDetails
Deleted a group.
is_company_managed Boolean? Is company managed group. Might be missing due to historical data gap. This field is optional.
group_moved_details GroupMovedDetails
GroupMovedDetails
Moved a group.
group_remove_external_id_details GroupRemoveExternalIdDetails
GroupRemoveExternalIdDetails
Removed the external ID for group.
previous_value String Old external id.
group_remove_member_details GroupRemoveMemberDetails
GroupRemoveMemberDetails
Removed team members from a group.
group_rename_details GroupRenameDetails
GroupRenameDetails
Renamed a 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_change_admin_role_details MemberChangeAdminRoleDetails
MemberChangeAdminRoleDetails
Change the admin role belonging to team member.
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 address.
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 the membership type (limited vs full) for team 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. 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 the membership status of a team member.
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
team_join_details JoinTeamDetails? Additional information relevant when a new member joins the team. This field is optional.
JoinTeamDetails
Additional information relevant when a new member joins the team.
linked_apps List of (AppLogInfo) Linked applications.
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.
linked_devices List of (DeviceLogInfo) Linked devices.
DeviceLogInfo
Device's logged information.
device_id String? Device unique id. Might be missing due to historical data gap. This field is optional.
display_name String? Device display name. Might be missing due to historical data gap. This field is optional.
is_emm_managed Boolean? True if this device is emm managed, false otherwise. Might be missing due to historical data gap. This field is optional.
platform String? Device platform name. Might be missing due to historical data gap. This field is optional.
mac_address String? Device mac address. Might be missing due to historical data gap. This field is optional.
os_version String? Device OS version. Might be missing due to historical data gap. This field is optional.
device_type String? Device type. Might be missing due to historical data gap. This field is optional.
ip_address String? IP address. Might be missing due to historical data gap. This field is optional.
last_activity String? Last activity. Might be missing due to historical data gap. This field is optional.
app_version String? Linking app version. 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.
member_permanently_delete_account_contents_details MemberPermanentlyDeleteAccountContentsDetails
MemberPermanentlyDeleteAccountContentsDetails
Permanently deleted contents of a removed team member account.
member_space_limits_change_status_details MemberSpaceLimitsChangeStatusDetails
MemberSpaceLimitsChangeStatusDetails
Changed the status with respect to whether the team member is under or over storage quota specified by policy.
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_suggest_details MemberSuggestDetails
MemberSuggestDetails
Suggested a new team member to be added to the team.
suggested_members List of (String(max_length=255)) suggested users emails.
member_transfer_account_contents_details MemberTransferAccountContentsDetails
MemberTransferAccountContentsDetails
Transferred contents of a removed team member account to another member.
src_participant_index UInt64 Source participant position in the Participants list.
dest_participant_index UInt64 Destination participant position in the Participants list.
paper_content_add_member_details PaperContentAddMemberDetails
PaperContentAddMemberDetails
Added users to the membership of a Paper doc or folder.
event_uuid String Event unique identifier.
paper_content_add_to_folder_details PaperContentAddToFolderDetails
PaperContentAddToFolderDetails
Added Paper doc or folder to a 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 or folder.
event_uuid String Event unique identifier.
paper_content_create_details PaperContentCreateDetails
PaperContentCreateDetails
Created a Paper doc or folder.
event_uuid String Event unique identifier.
paper_content_permanently_delete_details PaperContentPermanentlyDeleteDetails
PaperContentPermanentlyDeleteDetails
Permanently deleted a Paper doc or folder.
event_uuid String Event unique identifier.
paper_content_remove_from_folder_details PaperContentRemoveFromFolderDetails
PaperContentRemoveFromFolderDetails
Removed Paper doc or folder from a folder.
event_uuid String Event unique identifier.
paper_content_remove_member_details PaperContentRemoveMemberDetails
PaperContentRemoveMemberDetails
Removed a user from the membership of a Paper doc or folder.
event_uuid String Event unique identifier.
paper_content_rename_details PaperContentRenameDetails
PaperContentRenameDetails
Renamed Paper doc or folder.
event_uuid String Event unique identifier.
paper_content_restore_details PaperContentRestoreDetails
PaperContentRestoreDetails
Restored an archived Paper doc or folder.
event_uuid String Event unique identifier.
paper_doc_add_comment_details PaperDocAddCommentDetails
PaperDocAddCommentDetails
Added a 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 the access type of a Paper doc member.
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 the sharing policy 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 or unfollowed a 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
Paper doc archived.
event_uuid String Event unique identifier.
paper_doc_delete_comment_details PaperDocDeleteCommentDetails
PaperDocDeleteCommentDetails
Deleted a 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 a Paper doc in a particular output 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
paper_doc_edit_details PaperDocEditDetails
PaperDocEditDetails
Edited a Paper doc.
event_uuid String Event unique identifier.
paper_doc_edit_comment_details PaperDocEditCommentDetails
PaperDocEditCommentDetails
Edited a 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 a Paper doc.
event_uuid String Event unique identifier.
paper_doc_mention_details PaperDocMentionDetails
PaperDocMentionDetails
Mentioned a member in a Paper doc.
event_uuid String Event unique identifier.
paper_doc_request_access_details PaperDocRequestAccessDetails
PaperDocRequestAccessDetails
Requested to be a member on a Paper doc.
event_uuid String Event unique identifier.
paper_doc_resolve_comment_details PaperDocResolveCommentDetails
PaperDocResolveCommentDetails
Paper doc comment resolved.
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 a Paper doc to previous revision.
event_uuid String Event unique identifier.
paper_doc_slack_share_details PaperDocSlackShareDetails
PaperDocSlackShareDetails
Paper doc link shared via slack.
event_uuid String Event unique identifier.
paper_doc_team_invite_details PaperDocTeamInviteDetails
PaperDocTeamInviteDetails
Paper doc shared with team member.
event_uuid String Event unique identifier.
paper_doc_trashed_details PaperDocTrashedDetails
PaperDocTrashedDetails
Paper doc trashed.
event_uuid String Event unique identifier.
paper_doc_unresolve_comment_details PaperDocUnresolveCommentDetails
PaperDocUnresolveCommentDetails
Unresolved a 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
Paper doc untrashed.
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
Paper external sharing policy changed: anyone.
event_uuid String Event unique identifier.
paper_external_view_default_team_details PaperExternalViewDefaultTeamDetails
PaperExternalViewDefaultTeamDetails
Paper external sharing policy changed: default team.
event_uuid String Event unique identifier.
paper_external_view_forbid_details PaperExternalViewForbidDetails
PaperExternalViewForbidDetails
Paper external sharing policy changed: team-only.
event_uuid String Event unique identifier.
paper_folder_change_subscription_details PaperFolderChangeSubscriptionDetails
PaperFolderChangeSubscriptionDetails
Followed or unfollowed a 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
Paper folder archived.
event_uuid String Event unique identifier.
paper_folder_followed_details PaperFolderFollowedDetails
PaperFolderFollowedDetails
Followed a Paper folder.
event_uuid String Event unique identifier.
paper_folder_team_invite_details PaperFolderTeamInviteDetails
PaperFolderTeamInviteDetails
Paper folder shared with team 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
EMM excluded users report created.
emm_create_usage_report_details EmmCreateUsageReportDetails
EmmCreateUsageReportDetails
EMM mobile app usage report created.
paper_admin_export_start_details PaperAdminExportStartDetails
PaperAdminExportStartDetails
Exported all Paper documents in the team.
smart_sync_create_admin_privilege_report_details SmartSyncCreateAdminPrivilegeReportDetails
SmartSyncCreateAdminPrivilegeReportDetails
Smart Sync non-admin devices report created.
team_activity_create_report_details TeamActivityCreateReportDetails
TeamActivityCreateReportDetails
Created a 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 an album.
album_name String Album name.
note_acl_invite_only_details NoteAclInviteOnlyDetails
NoteAclInviteOnlyDetails
Changed a Paper document to be invite-only.
note_acl_link_details NoteAclLinkDetails
NoteAclLinkDetails
Changed a Paper document to be link accessible.
note_acl_team_link_details NoteAclTeamLinkDetails
NoteAclTeamLinkDetails
Changed a Paper document to be link accessible for the team.
note_shared_details NoteSharedDetails
NoteSharedDetails
Shared a Paper doc.
note_share_receive_details NoteShareReceiveDetails
NoteShareReceiveDetails
Shared Paper document received.
open_note_shared_details OpenNoteSharedDetails
OpenNoteSharedDetails
Opened a shared Paper doc.
sf_add_group_details SfAddGroupDetails
SfAddGroupDetails
Added the team to a 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 a 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
Admin settings: team members see a warning before sharing folders outside the team (DEPRECATED FEATURE).
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_invite_group_details SfInviteGroupDetails
SfInviteGroupDetails
Invited a group to a shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
sf_nest_details SfNestDetails
SfNestDetails
Changed parent of shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
prev_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.
sf_team_decline_details SfTeamDeclineDetails
SfTeamDeclineDetails
Declined a team member's invitation to a shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
sf_team_grant_access_details SfTeamGrantAccessDetails
SfTeamGrantAccessDetails
Granted access to a 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 a 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 a team member's role in a 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 a 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 a team member's shared folder from a 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 a folder with a 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
Sent an email invitation to the membership of a shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
shared_content_add_link_expiry_details SharedContentAddLinkExpiryDetails
SharedContentAddLinkExpiryDetails
Added an expiry to the link for the shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
expiration_start_date String Expiration starting date.
expiration_days UInt64 The number of days from the starting expiration date after which the link will expire.
original_folder_name String? Original shared folder name. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
shared_content_add_link_password_details SharedContentAddLinkPasswordDetails
SharedContentAddLinkPasswordDetails
Added a password to the link for the shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
shared_content_add_member_details SharedContentAddMemberDetails
SharedContentAddMemberDetails
Added users and/or groups to the membership of a shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
shared_content_change_downloads_policy_details SharedContentChangeDownloadsPolicyDetails
SharedContentChangeDownloadsPolicyDetails
Changed whether members can download the shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
new_value SharedContentDownloadsPolicy New downlaod policy.
SharedContentDownloadsPolicy (open union)
Shared content downloads policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
original_folder_name String? Original shared folder name. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
previous_value SharedContentDownloadsPolicy? Previous downlaod policy. Might be missing due to historical data gap. This field is optional.
SharedContentDownloadsPolicy (open union)
Shared content downloads policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
shared_content_change_invitee_role_details SharedContentChangeInviteeRoleDetails
SharedContentChangeInviteeRoleDetails
Changed the access type of an invitee to a shared file or folder before the invitation was claimed.
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.
shared_content_change_link_audience_details SharedContentChangeLinkAudienceDetails
SharedContentChangeLinkAudienceDetails
Changed the audience of the link for a shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
new_value LinkAudience New link audience value.
LinkAudience (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
public Void
team Void
members Void
original_folder_name String? Original shared folder name. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
previous_value LinkAudience? Previous link audience value. Might be missing due to historical data gap. This field is optional.
LinkAudience (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
public Void
team Void
members Void
shared_content_change_link_expiry_details SharedContentChangeLinkExpiryDetails
SharedContentChangeLinkExpiryDetails
Changed the expiry of the link for the shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
expiration_start_date String Expiration starting date.
expiration_days UInt64 The number of days from the starting expiration date after which the link will expire.
original_folder_name String? Original shared folder name. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
shared_content_change_link_password_details SharedContentChangeLinkPasswordDetails
SharedContentChangeLinkPasswordDetails
Changed the password on the link for the shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
shared_content_change_member_role_details SharedContentChangeMemberRoleDetails
SharedContentChangeMemberRoleDetails
Changed the access type of a shared file or folder member.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
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.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
shared_content_change_viewer_info_policy_details SharedContentChangeViewerInfoPolicyDetails
SharedContentChangeViewerInfoPolicyDetails
Changed whether members can see who viewed the shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
new_value SharedContentViewerInfoPolicy New viewer info policy.
SharedContentViewerInfoPolicy (open union)
Shared content viewer info policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
original_folder_name String? Original shared folder name. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
previous_value SharedContentViewerInfoPolicy? Previous view info policy. Might be missing due to historical data gap. This field is optional.
SharedContentViewerInfoPolicy (open union)
Shared content viewer info policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
shared_content_claim_invitation_details SharedContentClaimInvitationDetails
SharedContentClaimInvitationDetails
Claimed membership to a team member's shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
shared_content_link String? Shared content link. This field is optional.
shared_content_copy_details SharedContentCopyDetails
SharedContentCopyDetails
Copied the shared file or folder to own Dropbox.
shared_content_link String Shared content link.
target_asset_index UInt64 Target asset position in the Assets list.
relocate_action_details RelocateAssetReferencesLogInfo Specifies the source and destination indices in the assets list.
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.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
shared_content_download_details SharedContentDownloadDetails
SharedContentDownloadDetails
Downloaded the shared file or folder.
shared_content_link String Shared content link.
target_asset_index UInt64 Target asset position in the Assets list.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
shared_content_relinquish_membership_details SharedContentRelinquishMembershipDetails
SharedContentRelinquishMembershipDetails
Left the membership of a shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
shared_content_remove_invitee_details SharedContentRemoveInviteeDetails
SharedContentRemoveInviteeDetails
Removed an invitee from the membership of a shared file or folder before it was claimed.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
shared_content_remove_link_expiry_details SharedContentRemoveLinkExpiryDetails
SharedContentRemoveLinkExpiryDetails
Removed the expiry of the link for the shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
shared_content_remove_link_password_details SharedContentRemoveLinkPasswordDetails
SharedContentRemoveLinkPasswordDetails
Removed the password on the link for the shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
shared_content_remove_member_details SharedContentRemoveMemberDetails
SharedContentRemoveMemberDetails
Removed a user or a group from the membership of a shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
shared_content_request_access_details SharedContentRequestAccessDetails
SharedContentRequestAccessDetails
Requested to be on the membership of a shared file or folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
shared_content_link String? Shared content link. This field is optional.
shared_content_unshare_details SharedContentUnshareDetails
SharedContentUnshareDetails
Unshared a shared file or folder by clearing its membership and turning off its link.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String? Original shared folder name. This field is optional.
shared_content_view_details SharedContentViewDetails
SharedContentViewDetails
Previewed the shared file or folder.
shared_content_link String Shared content link.
target_asset_index UInt64 Target asset position in the Assets list.
sharing_permission String? Sharing permission. Might be missing due to historical data gap. This field is optional.
shared_folder_change_confidentiality_details SharedFolderChangeConfidentialityDetails
SharedFolderChangeConfidentialityDetails
Set or unset the confidential flag on a shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
new_value Confidentiality New confidentiality value.
Confidentiality (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
confidential Void
non_confidential Void
previous_value Confidentiality? Previous confidentiality value. Might be missing due to historical data gap. This field is optional.
Confidentiality (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
confidential Void
non_confidential Void
shared_folder_change_link_policy_details SharedFolderChangeLinkPolicyDetails
SharedFolderChangeLinkPolicyDetails
Changed who can access the shared folder via a link.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
new_value SharedFolderLinkPolicy New shared folder link policy.
SharedFolderLinkPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
members_only Void
members_and_team Void
anyone Void
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
previous_value SharedFolderLinkPolicy? Previous shared folder link policy. Might be missing due to historical data gap. This field is optional.
SharedFolderLinkPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
members_only Void
members_and_team Void
anyone Void
shared_folder_change_member_management_policy_details SharedFolderChangeMemberManagementPolicyDetails
SharedFolderChangeMemberManagementPolicyDetails
Changed who can manage the membership of a shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
new_value SharedFolderMembershipManagementPolicy New membership management policy.
SharedFolderMembershipManagementPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void
editors Void
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
previous_value SharedFolderMembershipManagementPolicy? Previous membership management policy. Might be missing due to historical data gap. This field is optional.
SharedFolderMembershipManagementPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
owner Void
editors Void
shared_folder_change_member_policy_details SharedFolderChangeMemberPolicyDetails
SharedFolderChangeMemberPolicyDetails
Changed who can become a member of the shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
new_value SharedFolderMemberPolicy New external invite policy.
SharedFolderMemberPolicy (open union)
Policy for controlling who can become a member of a shared folder The value will be one of the following datatypes. New values may be introduced as our API evolves.
team_only Void
anyone Void
shared_folder_type String? Shared folder type. Might be missing due to historical data gap. This field is optional.
previous_value SharedFolderMemberPolicy? Previous external invite policy. Might be missing due to historical data gap. This field is optional.
SharedFolderMemberPolicy (open union)
Policy for controlling who can become a member of a shared folder The value will be one of the following datatypes. New values may be introduced as our API evolves.
team_only Void
anyone Void
shared_folder_create_details SharedFolderCreateDetails
SharedFolderCreateDetails
Created a shared folder.
target_ns_id String? Target namespace ID. Might be missing due to historical data gap. This field is optional.
shared_folder_mount_details SharedFolderMountDetails
SharedFolderMountDetails
Added a shared folder to own Dropbox.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
shared_folder_transfer_ownership_details SharedFolderTransferOwnershipDetails
SharedFolderTransferOwnershipDetails
Transferred the ownership of a shared folder to another member.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
shared_folder_unmount_details SharedFolderUnmountDetails
SharedFolderUnmountDetails
Deleted a shared folder from Dropbox.
target_asset_index UInt64 Target asset position in the Assets list.
original_folder_name String Original shared folder name.
shared_link_add_expiry_details SharedLinkAddExpiryDetails
SharedLinkAddExpiryDetails
Added a 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 the 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 the visibility of a 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 a file/folder to their Dropbox from a 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(min_length=1)? 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(min_length=1)? 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 a new 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 a 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(min_length=1)? 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(min_length=1)? 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 a file/folder from a 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(min_length=1)? 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(min_length=1)? 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 a 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 new members as the audience of a 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(min_length=1)? 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(min_length=1)? 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 a 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(min_length=1)? 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(min_length=1)? 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
Shared Paper document was opened.
shmodel_group_share_details ShmodelGroupShareDetails
ShmodelGroupShareDetails
Shared a link with a group.
sso_add_cert_details SsoAddCertDetails
SsoAddCertDetails
Added the 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 the 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 the 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 the 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 the 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 the X.509 certificate for SSO.
sso_remove_login_url_details SsoRemoveLoginUrlDetails
SsoRemoveLoginUrlDetails
Removed the sign-in URL for SSO.
previous_value String Previous single sign-on login URL.
sso_remove_logout_url_details SsoRemoveLogoutUrlDetails
SsoRemoveLogoutUrlDetails
Removed single sign-on logout URL.
previous_value String Previous single sign-on logout URL.
team_folder_change_status_details TeamFolderChangeStatusDetails
TeamFolderChangeStatusDetails
Changed the archival status of a 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 a new team folder in active status.
team_folder_downgrade_details TeamFolderDowngradeDetails
TeamFolderDowngradeDetails
Downgraded a team folder to a regular shared folder.
target_asset_index UInt64 Target asset position in the Assets list.
team_folder_permanently_delete_details TeamFolderPermanentlyDeleteDetails
TeamFolderPermanentlyDeleteDetails
Permanently deleted an archived team folder.
team_folder_rename_details TeamFolderRenameDetails
TeamFolderRenameDetails
Renamed an active or archived team folder.
relocate_action_details RelocateAssetReferencesLogInfo Specifies the source and destination indices in the assets list.
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.
account_capture_change_policy_details AccountCaptureChangePolicyDetails
AccountCaptureChangePolicyDetails
Changed the account capture policy on a domain belonging to the team.
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 allow downloads.
allow_download_enabled_details AllowDownloadEnabledDetails
AllowDownloadEnabledDetails
Enabled allow downloads.
data_placement_restriction_change_policy_details DataPlacementRestrictionChangePolicyDetails
DataPlacementRestrictionChangePolicyDetails
Set a restriction policy regarding the location of data centers 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 PlacementRestriction New 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
data_placement_restriction_satisfy_policy_details DataPlacementRestrictionSatisfyPolicyDetails
DataPlacementRestrictionSatisfyPolicyDetails
Satisfied a previously set restriction policy regarding the location of data centers where team data resides (i.e. all data have been migrated according to the restriction placed).
placement_restriction PlacementRestriction 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
device_approvals_change_desktop_policy_details DeviceApprovalsChangeDesktopPolicyDetails
DeviceApprovalsChangeDesktopPolicyDetails
Set or removed a limit on the number of computers each team member can link to their work Dropbox account.
new_value DeviceApprovalsPolicy? New desktop device approvals policy. Might be missing due to historical data gap. This field is optional.
DeviceApprovalsPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
unlimited Void
limited Void
previous_value DeviceApprovalsPolicy? Previous desktop device approvals policy. Might be missing due to historical data gap. This field is optional.
DeviceApprovalsPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
unlimited Void
limited Void
device_approvals_change_mobile_policy_details DeviceApprovalsChangeMobilePolicyDetails
DeviceApprovalsChangeMobilePolicyDetails
Set or removed a limit on the number of mobiles devices each team member can link to their work Dropbox account.
new_value DeviceApprovalsPolicy? New mobile device approvals policy. Might be missing due to historical data gap. This field is optional.
DeviceApprovalsPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
unlimited Void
limited Void
previous_value DeviceApprovalsPolicy? Previous mobile device approvals policy. Might be missing due to historical data gap. This field is optional.
DeviceApprovalsPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
unlimited Void
limited Void
device_approvals_change_overage_action_details DeviceApprovalsChangeOverageActionDetails
DeviceApprovalsChangeOverageActionDetails
Changed the action taken when a team member is already over the limits (e.g when they join the team, an admin lowers limits, etc.).
new_value RolloutMethod? New over the limits policy. Might be missing due to historical data gap. This field is optional.
RolloutMethod (union)
This datatype comes from an imported namespace originally defined in the team_policies namespace. The value will be one of the following datatypes:
unlink_all Void Unlink all.
unlink_most_inactive Void Unlink devices with the most inactivity.
add_member_to_exceptions Void Add member to Exceptions.
previous_value RolloutMethod? Previous over the limit policy. Might be missing due to historical data gap. This field is optional.
RolloutMethod (union)
This datatype comes from an imported namespace originally defined in the team_policies namespace. The value will be one of the following datatypes:
unlink_all Void Unlink all.
unlink_most_inactive Void Unlink devices with the most inactivity.
add_member_to_exceptions Void Add member to Exceptions.
device_approvals_change_unlink_action_details DeviceApprovalsChangeUnlinkActionDetails
DeviceApprovalsChangeUnlinkActionDetails
Changed the action taken with respect to approval limits when a team member unlinks an approved device.
new_value DeviceUnlinkPolicy? New device unlink policy. Might be missing due to historical data gap. This field is optional.
DeviceUnlinkPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
remove Void
keep Void
previous_value DeviceUnlinkPolicy? Previous device unlink policy. Might be missing due to historical data gap. This field is optional.
DeviceUnlinkPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
remove Void
keep Void
emm_add_exception_details EmmAddExceptionDetails
EmmAddExceptionDetails
Added an exception for one or more team members to optionally use the regular Dropbox app when EMM is enabled.
emm_change_policy_details EmmChangePolicyDetails
EmmChangePolicyDetails
Enabled or disabled enterprise mobility management for team members.
new_value EmmState New enterprise mobility management policy.
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.
previous_value EmmState? Previous enterprise mobility management policy. Might be missing due to historical data gap. This field is optional.
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.
emm_remove_exception_details EmmRemoveExceptionDetails
EmmRemoveExceptionDetails
Removed an exception for one or more team members to optionally use the regular Dropbox app when EMM is enabled.
extended_version_history_change_policy_details ExtendedVersionHistoryChangePolicyDetails
ExtendedVersionHistoryChangePolicyDetails
Accepted or opted out of extended version history.
new_value ExtendedVersionHistoryPolicy New extended version history policy.
ExtendedVersionHistoryPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
explicitly_limited Void
explicitly_unlimited Void
implicitly_limited Void
previous_value ExtendedVersionHistoryPolicy? Previous extended version history policy. Might be missing due to historical data gap. This field is optional.
ExtendedVersionHistoryPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
explicitly_limited Void
explicitly_unlimited Void
implicitly_limited Void
file_comments_change_policy_details FileCommentsChangePolicyDetails
FileCommentsChangePolicyDetails
Enabled or disabled commenting on team files.
new_value FileCommentsPolicy New commenting on team files policy.
FileCommentsPolicy (open union)
File comments policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
previous_value FileCommentsPolicy? Previous commenting on team files policy. Might be missing due to historical data gap. This field is optional.
FileCommentsPolicy (open union)
File comments policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
file_requests_change_policy_details FileRequestsChangePolicyDetails
FileRequestsChangePolicyDetails
Enabled or disabled file requests.
new_value FileRequestsPolicy New file requests policy.
FileRequestsPolicy (open union)
File requests policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
previous_value FileRequestsPolicy? Previous file requests policy. Might be missing due to historical data gap. This field is optional.
FileRequestsPolicy (open union)
File requests policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
file_requests_emails_enabled_details FileRequestsEmailsEnabledDetails
FileRequestsEmailsEnabledDetails
Enabled file request emails for everyone.
file_requests_emails_restricted_to_team_only_details FileRequestsEmailsRestrictedToTeamOnlyDetails
FileRequestsEmailsRestrictedToTeamOnlyDetails
Allowed file request emails for the team.
google_sso_change_policy_details GoogleSsoChangePolicyDetails
GoogleSsoChangePolicyDetails
Enabled or disabled Google single sign-on for the team.
new_value GoogleSsoPolicy New Google single sign-on policy.
GoogleSsoPolicy (open union)
Google SSO policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
previous_value GoogleSsoPolicy? Previous Google single sign-on policy. Might be missing due to historical data gap. This field is optional.
GoogleSsoPolicy (open union)
Google SSO policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
group_user_management_change_policy_details GroupUserManagementChangePolicyDetails
GroupUserManagementChangePolicyDetails
Changed who can create groups.
new_value GroupCreation New group users management policy.
GroupCreation (union)
This datatype comes from an imported namespace originally defined in the team_policies namespace. The value will be one of the following datatypes:
admins_and_members Void Team admins and members can create groups.
admins_only Void Only team admins can create groups.
previous_value GroupCreation? Previous group users management policy. Might be missing due to historical data gap. This field is optional.
GroupCreation (union)
This datatype comes from an imported namespace originally defined in the team_policies namespace. The value will be one of the following datatypes:
admins_and_members Void Team admins and members can create groups.
admins_only Void Only team admins can create groups.
member_requests_change_policy_details MemberRequestsChangePolicyDetails
MemberRequestsChangePolicyDetails
Changed whether users can find the team when not invited.
new_value MemberRequestsPolicy New member change requests policy.
MemberRequestsPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
auto_accept Void
disabled Void
require_approval Void
previous_value MemberRequestsPolicy? Previous member change requests policy. Might be missing due to historical data gap. This field is optional.
MemberRequestsPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
auto_accept Void
disabled Void
require_approval Void
member_space_limits_add_exception_details MemberSpaceLimitsAddExceptionDetails
MemberSpaceLimitsAddExceptionDetails
Added an exception for one or more team members to bypass space limits imposed by policy.
member_space_limits_change_policy_details MemberSpaceLimitsChangePolicyDetails
MemberSpaceLimitsChangePolicyDetails
Changed the team default limit level.
previous_value UInt64? Previous team default limit value in bytes. Might be missing due to historical data gap. This field is optional.
new_value UInt64? New team default limit value in bytes. Might be missing due to historical data gap. This field is optional.
member_space_limits_remove_exception_details MemberSpaceLimitsRemoveExceptionDetails
MemberSpaceLimitsRemoveExceptionDetails
Removed an exception for one or more team members to bypass space limits imposed by policy.
member_suggestions_change_policy_details MemberSuggestionsChangePolicyDetails
MemberSuggestionsChangePolicyDetails
Enabled or disabled the option for team members to suggest new members to add to the team.
new_value MemberSuggestionsPolicy New team member suggestions policy.
MemberSuggestionsPolicy (open union)
Member suggestions policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
previous_value MemberSuggestionsPolicy? Previous team member suggestions policy. Might be missing due to historical data gap. This field is optional.
MemberSuggestionsPolicy (open union)
Member suggestions policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
microsoft_office_addin_change_policy_details MicrosoftOfficeAddinChangePolicyDetails
MicrosoftOfficeAddinChangePolicyDetails
Enabled or disabled the Microsoft Office add-in, which lets team members save files to Dropbox directly from Microsoft Office.
new_value MicrosoftOfficeAddinPolicy New Microsoft Office addin policy.
MicrosoftOfficeAddinPolicy (open union)
Microsoft Office addin policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
previous_value MicrosoftOfficeAddinPolicy? Previous Microsoft Office addin policy. Might be missing due to historical data gap. This field is optional.
MicrosoftOfficeAddinPolicy (open union)
Microsoft Office addin policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
network_control_change_policy_details NetworkControlChangePolicyDetails
NetworkControlChangePolicyDetails
Enabled or disabled network control.
new_value NetworkControlPolicy New network control policy.
NetworkControlPolicy (open union)
Network control policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
previous_value NetworkControlPolicy? Previous network control policy. Might be missing due to historical data gap. This field is optional.
NetworkControlPolicy (open union)
Network control policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
paper_change_deployment_policy_details PaperChangeDeploymentPolicyDetails
PaperChangeDeploymentPolicyDetails
Changed whether Dropbox Paper, when enabled, is deployed to all teams or to specific members of the team.
new_value PaperDeploymentPolicy New Dropbox Paper deployment policy.
PaperDeploymentPolicy (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.
full Void All team members have access to Paper.
partial Void Only whitelisted team members can access Paper. To see which user is whitelisted, check 'is_paper_whitelisted' on 'account/info'.
previous_value PaperDeploymentPolicy? Previous Dropbox Paper deployment policy. Might be missing due to historical data gap. This field is optional.
PaperDeploymentPolicy (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.
full Void All team members have access to Paper.
partial Void Only whitelisted team members can access Paper. To see which user is whitelisted, check 'is_paper_whitelisted' on 'account/info'.
paper_change_member_link_policy_details PaperChangeMemberLinkPolicyDetails
PaperChangeMemberLinkPolicyDetails
Changed whether non team members can view Paper documents using a link.
new_value PaperMemberPolicy New paper external link accessibility policy.
PaperMemberPolicy (open union)
Policy for controlling if team members can share Paper documents externally. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone_with_link Void
only_team Void
team_and_explicitly_shared Void
paper_change_member_policy_details PaperChangeMemberPolicyDetails
PaperChangeMemberPolicyDetails
Changed whether team members can share Paper documents externally (i.e. outside the team), and if so, whether they should be accessible only by team members or anyone by default.
new_value PaperMemberPolicy New paper external accessibility policy.
PaperMemberPolicy (open union)
Policy for controlling if team members can share Paper documents externally. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone_with_link Void
only_team Void
team_and_explicitly_shared Void
previous_value PaperMemberPolicy? Previous paper external accessibility policy. Might be missing due to historical data gap. This field is optional.
PaperMemberPolicy (open union)
Policy for controlling if team members can share Paper documents externally. The value will be one of the following datatypes. New values may be introduced as our API evolves.
anyone_with_link Void
only_team Void
team_and_explicitly_shared Void
paper_change_policy_details PaperChangePolicyDetails
PaperChangePolicyDetails
Enabled or disabled Dropbox Paper for the team.
new_value PaperEnabledPolicy New Dropbox Paper policy.
PaperEnabledPolicy (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 Paper is disabled.
enabled Void Paper is enabled.
unspecified Void Unspecified policy.
previous_value PaperEnabledPolicy? Previous Dropbox Paper policy. Might be missing due to historical data gap. This field is optional.
PaperEnabledPolicy (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 Paper is disabled.
enabled Void Paper is enabled.
unspecified Void Unspecified policy.
paper_enabled_users_group_addition_details PaperEnabledUsersGroupAdditionDetails
PaperEnabledUsersGroupAdditionDetails
Users added to Paper enabled users list.
paper_enabled_users_group_removal_details PaperEnabledUsersGroupRemovalDetails
PaperEnabledUsersGroupRemovalDetails
Users removed from Paper enabled users list.
permanent_delete_change_policy_details PermanentDeleteChangePolicyDetails
PermanentDeleteChangePolicyDetails
Enabled or disabled the ability of team members to permanently delete content.
new_value ContentPermanentDeletePolicy New permanent delete content policy.
ContentPermanentDeletePolicy (open union)
Policy for pemanent content deletion The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
previous_value ContentPermanentDeletePolicy? Previous permanent delete content policy. Might be missing due to historical data gap. This field is optional.
ContentPermanentDeletePolicy (open union)
Policy for pemanent content deletion The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
sharing_change_folder_join_policy_details SharingChangeFolderJoinPolicyDetails
SharingChangeFolderJoinPolicyDetails
Changed whether team members can join shared folders owned externally (i.e. outside the team).
new_value SharingFolderJoinPolicy New external join policy.
SharingFolderJoinPolicy (open union)
Policy for controlling if team members can join shared folders owned by non team members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
from_anyone Void
from_team_only Void
previous_value SharingFolderJoinPolicy? Previous external join policy. Might be missing due to historical data gap. This field is optional.
SharingFolderJoinPolicy (open union)
Policy for controlling if team members can join shared folders owned by non team members. The value will be one of the following datatypes. New values may be introduced as our API evolves.
from_anyone Void
from_team_only Void
sharing_change_link_policy_details SharingChangeLinkPolicyDetails
SharingChangeLinkPolicyDetails
Changed whether team members can share links externally (i.e. outside the team), and if so, whether links should be accessible only by team members or anyone by default.
new_value SharingLinkPolicy New external link accessibility policy.
SharingLinkPolicy (open union)
Policy for controlling if team members can share links externally The value will be one of the following datatypes. New values may be introduced as our API evolves.
default_private Void
default_public Void
only_private Void
previous_value SharingLinkPolicy? Previous external link accessibility policy. Might be missing due to historical data gap. This field is optional.
SharingLinkPolicy (open union)
Policy for controlling if team members can share links externally The value will be one of the following datatypes. New values may be introduced as our API evolves.
default_private Void
default_public Void
only_private Void
sharing_change_member_policy_details SharingChangeMemberPolicyDetails
SharingChangeMemberPolicyDetails
Changed whether team members can share files and folders externally (i.e. outside the team).
new_value SharingMemberPolicy New external invite policy.
SharingMemberPolicy (open union)
External sharing policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
allow Void
forbid Void
previous_value SharingMemberPolicy? Previous external invite policy. Might be missing due to historical data gap. This field is optional.
SharingMemberPolicy (open union)
External sharing policy The value will be one of the following datatypes. New values may be introduced as our API evolves.
allow Void
forbid Void
smart_sync_change_policy_details SmartSyncChangePolicyDetails
SmartSyncChangePolicyDetails
Changed the default Smart Sync policy for team members.
new_value SmartSyncPolicy? New smart sync policy. This field is optional.
SmartSyncPolicy (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.
local Void The specified content will be synced as local files by default.
on_demand Void The specified content will be synced as on-demand files by default.
previous_value SmartSyncPolicy? Previous smart sync policy. This field is optional.
SmartSyncPolicy (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.
local Void The specified content will be synced as local files by default.
on_demand Void The specified content will be synced as on-demand files by default.
smart_sync_not_opt_out_details SmartSyncNotOptOutDetails
SmartSyncNotOptOutDetails
Opted team into Smart Sync.
previous_value SmartSyncOptOutPolicy Previous Smart Sync opt out policy.
SmartSyncOptOutPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void
opted_out Void
new_value SmartSyncOptOutPolicy New Smart Sync opt out policy.
SmartSyncOptOutPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void
opted_out Void
smart_sync_opt_out_details SmartSyncOptOutDetails
SmartSyncOptOutDetails
Opted team out of Smart Sync.
previous_value SmartSyncOptOutPolicy Previous Smart Sync opt out policy.
SmartSyncOptOutPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void
opted_out Void
new_value SmartSyncOptOutPolicy New Smart Sync opt out policy.
SmartSyncOptOutPolicy (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
default Void
opted_out Void
sso_change_policy_details SsoChangePolicyDetails
SsoChangePolicyDetails
Change the single sign-on policy for the team.
new_value SsoPolicy New single sign-on policy.
SsoPolicy (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 Users will be able to sign in with their Dropbox credentials.
optional Void Users will be able to sign in with either their Dropbox or single sign-on credentials.
required Void Users will be required to sign in with their single sign-on credentials.
previous_value SsoPolicy? Previous single sign-on policy. Might be missing due to historical data gap. This field is optional.
SsoPolicy (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 Users will be able to sign in with their Dropbox credentials.
optional Void Users will be able to sign in with either their Dropbox or single sign-on credentials.
required Void Users will be required to sign in with their single sign-on credentials.
tfa_change_policy_details TfaChangePolicyDetails
TfaChangePolicyDetails
Change two-step verification policy for the team.
new_value TwoStepVerificationPolicy New change policy.
TwoStepVerificationPolicy (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.
require_tfa_enable Void Enabled require two factor authorization.
require_tfa_disable Void Disabled require two factor authorization.
previous_value TwoStepVerificationPolicy? Previous change policy. Might be missing due to historical data gap. This field is optional.
TwoStepVerificationPolicy (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.
require_tfa_enable Void Enabled require two factor authorization.
require_tfa_disable Void Disabled require two factor authorization.
two_account_change_policy_details TwoAccountChangePolicyDetails
TwoAccountChangePolicyDetails
Enabled or disabled the option for team members to link a personal Dropbox account in addition to their work account to the same computer.
new_value TwoAccountPolicy New two account policy.
TwoAccountPolicy (open union)
Policy for pairing personal account to work account The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
previous_value TwoAccountPolicy? Previous two account policy. Might be missing due to historical data gap. This field is optional.
TwoAccountPolicy (open union)
Policy for pairing personal account to work account The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
web_sessions_change_fixed_length_policy_details WebSessionsChangeFixedLengthPolicyDetails
WebSessionsChangeFixedLengthPolicyDetails
Changed how long team members can stay signed in to Dropbox on the web.
new_value WebSessionsFixedLengthPolicy? New session length policy. Might be missing due to historical data gap. This field is optional.
WebSessionsFixedLengthPolicy (open union)
Web sessions fixed length policy. The value will be one of the following datatypes. New values may be introduced as our API evolves.
defined DurationLogInfo Defined fixed session length.
DurationLogInfo
Represents a time duration: unit and amount
unit TimeUnit Time unit.
TimeUnit (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
milliseconds Void
seconds Void
minutes Void
hours Void
days Void
weeks Void
months Void
years Void
amount UInt64 Amount of time.
undefined Void Undefined fixed session length.
previous_value WebSessionsFixedLengthPolicy? Previous session length policy. Might be missing due to historical data gap. This field is optional.
WebSessionsFixedLengthPolicy (open union)
Web sessions fixed length policy. The value will be one of the following datatypes. New values may be introduced as our API evolves.
defined DurationLogInfo Defined fixed session length.
DurationLogInfo
Represents a time duration: unit and amount
unit TimeUnit Time unit.
TimeUnit (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
milliseconds Void
seconds Void
minutes Void
hours Void
days Void
weeks Void
months Void
years Void
amount UInt64 Amount of time.
undefined Void Undefined fixed session length.
web_sessions_change_idle_length_policy_details WebSessionsChangeIdleLengthPolicyDetails
WebSessionsChangeIdleLengthPolicyDetails
Changed how long team members can be idle while signed in to Dropbox on the web.
new_value WebSessionsIdleLengthPolicy? New idle length policy. Might be missing due to historical data gap. This field is optional.
WebSessionsIdleLengthPolicy (open union)
Web sessions idle length policy. The value will be one of the following datatypes. New values may be introduced as our API evolves.
defined DurationLogInfo Defined idle session length.
DurationLogInfo
Represents a time duration: unit and amount
unit TimeUnit Time unit.
TimeUnit (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
milliseconds Void
seconds Void
minutes Void
hours Void
days Void
weeks Void
months Void
years Void
amount UInt64 Amount of time.
undefined Void Undefined idle session length.
previous_value WebSessionsIdleLengthPolicy? Previous idle length policy. Might be missing due to historical data gap. This field is optional.
WebSessionsIdleLengthPolicy (open union)
Web sessions idle length policy. The value will be one of the following datatypes. New values may be introduced as our API evolves.
defined DurationLogInfo Defined idle session length.
DurationLogInfo
Represents a time duration: unit and amount
unit TimeUnit Time unit.
TimeUnit (open union)
The value will be one of the following datatypes. New values may be introduced as our API evolves.
milliseconds Void
seconds Void
minutes Void
hours Void
days Void
weeks Void
months Void
years Void
amount UInt64 Amount of time.
undefined Void Undefined idle session length.
team_merge_from_details TeamMergeFromDetails
TeamMergeFromDetails
Merged another team into this team.
team_name String The name of the team that was merged into this team.
team_merge_to_details TeamMergeToDetails
TeamMergeToDetails
Merged this team into another team.
team_name String The name of the team that this team was merged into.
team_profile_add_logo_details TeamProfileAddLogoDetails
TeamProfileAddLogoDetails
Added a team logo to be displayed on shared link headers.
team_profile_change_default_language_details TeamProfileChangeDefaultLanguageDetails
TeamProfileChangeDefaultLanguageDetails
Changed the default language for the team.
new_value String(min_length=2) New team's default language.
previous_value String(min_length=2) Previous team's default language.
team_profile_change_logo_details TeamProfileChangeLogoDetails
TeamProfileChangeLogoDetails
Changed the team logo to be displayed on shared link headers.
team_profile_change_name_details TeamProfileChangeNameDetails
TeamProfileChangeNameDetails
Changed the team name.
new_value TeamName New team name.
TeamName
Team name details
team_display_name String Team's display name.
team_legal_name String Team's legal name.
previous_value TeamName? Previous teams name. Might be missing due to historical data gap. This field is optional.
TeamName
Team name details
team_display_name String Team's display name.
team_legal_name String Team's legal name.
team_profile_remove_logo_details TeamProfileRemoveLogoDetails
TeamProfileRemoveLogoDetails
Removed the team logo to be displayed on shared link headers.
tfa_add_backup_phone_details TfaAddBackupPhoneDetails
TfaAddBackupPhoneDetails
Added a backup phone for two-step verification.
tfa_add_security_key_details TfaAddSecurityKeyDetails
TfaAddSecurityKeyDetails
Added a security key for two-step verification.
tfa_change_backup_phone_details TfaChangeBackupPhoneDetails
TfaChangeBackupPhoneDetails
Changed the backup phone for two-step verification.
tfa_change_status_details TfaChangeStatusDetails
TfaChangeStatusDetails
Enabled, disabled or changed the configuration for two-step verification.
new_value TfaConfiguration The new two factor authentication configuration.
TfaConfiguration (open union)
Two factor authentication configuration. Note: the enabled option is deprecated. The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
sms Void
authenticator Void
previous_value TfaConfiguration? The previous two factor authentication configuration. Might be missing due to historical data gap. This field is optional.
TfaConfiguration (open union)
Two factor authentication configuration. Note: the enabled option is deprecated. The value will be one of the following datatypes. New values may be introduced as our API evolves.
disabled Void
enabled Void
sms Void
authenticator Void
used_rescue_code Boolean? Used two factor authentication rescue code. This flag is relevant when the two factor authentication configuration is disabled. This field is optional.
tfa_remove_backup_phone_details TfaRemoveBackupPhoneDetails
TfaRemoveBackupPhoneDetails
Removed the backup phone for two-step verification.
tfa_remove_security_key_details TfaRemoveSecurityKeyDetails
TfaRemoveSecurityKeyDetails
Removed a security key for two-step verification.
tfa_reset_details TfaResetDetails
TfaResetDetails
Reset two-step verification for team member.
missing_details MissingDetails Hints that this event was returned with missing details due to an internal error.
MissingDetails
An indication that an event was returned with missing details
origin OriginLogInfo? The origin from which the actor performed the action including information about host, ip address, location, session, etc. If the action was performed programmatically via the API the origin represents the API client. This field is optional.
OriginLogInfo
The origin from which the actor performed the action.
access_method AccessMethodLogInfo The method that was used to perform the action.
AccessMethodLogInfo (open union)
Indicates the method in which the action was performed. The value will be one of the following datatypes. New values may be introduced as our API evolves.
end_user SessionLogInfo End user session details.
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.
sign_in_as WebSessionLogInfo Sign in as session details.
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
content_manager WebSessionLogInfo Content manager session details.
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
admin_console WebSessionLogInfo Admin console session details.
WebSessionLogInfo
Web session.
session_id String? Session ID. Might be missing due to historical data gap. This field is optional.
api ApiSessionLogInfo Api session details.
ApiSessionLogInfo
Api session.
request_id String Api request ID.
geo_location GeoLocationLogInfo? Geographic location details. This field is optional.
GeoLocationLogInfo
Geographic location details.
ip_address String IP address.
city String? City name. This field is optional.
region String? Region name. This field is optional.
country String? Country code. This field is optional.
participants List of (ParticipantLogInfo)? Zero or more users and/or groups that are affected by the action. Note that this list doesn't include any actors or users in context. This field is optional.
ParticipantLogInfo (open union)
A user or group The value will be one of the following datatypes. New values may be introduced as our API evolves.
user UserLogInfo A user with a Dropbox account.
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(min_length=1)? 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(min_length=1)? 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.
group GroupLogInfo Group details.
GroupLogInfo
Group's logged information.
display_name String The name of this group.
group_id String? The unique id of this group. Might be missing due to historical data gap. This field is optional.
external_id String? External group ID. Might be missing due to historical data gap. This field is optional.
assets List of (AssetLogInfo)? Zero or more content assets involved in the action. Currently these include Dropbox files and folders but in the future we might add other asset types such as Paper documents, folders, projects, etc. This field is optional.
AssetLogInfo (open union)
Asset details. The value will be one of the following datatypes. New values may be introduced as our API evolves.
file FileLogInfo File's details.
FileLogInfo
File'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.
folder FolderLogInfo Folder's details.
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.
paper_document PaperDocumentLogInfo Paper docuement's details.
PaperDocumentLogInfo
Paper document's logged information.
doc_id String Papers document Id.
doc_title String Paper document title.
paper_folder PaperFolderLogInfo Paper folder's details.
PaperFolderLogInfo
Paper folder's logged information.
folder_id String Papers folder Id.
folder_name String Paper folder name.
cursor String Pass the cursor into get_events/continue to obtain additional events.
has_more Boolean Is true if there are additional events that have not been returned yet. An additional call to get_events/continue can retrieve them.
Errors
{
    "error_summary": "account_id_not_found/...",
    "error": {
        ".tag": "account_id_not_found"
    }
}
Example: account_id_not_found
{
    "error_summary": "account_id_not_found/...",
    "error": {
        ".tag": "account_id_not_found"
    }
}
Example: invalid_time_range
{
    "error_summary": "invalid_time_range/...",
    "error": {
        ".tag": "invalid_time_range"
    }
}
Example: other
{
    "error_summary": "other/...",
    "error": {
        ".tag": "other"
    }
}
GetTeamEventsError (open union)
Errors that can be raised when calling get_events. The value will be one of the following datatypes. New values may be introduced as our API evolves.
account_id_not_found Void No user found matching the provided account_id.
invalid_time_range Void Invalid time range.

/get_events/continue

PREVIEW - may change or disappear without notice
Description

Once a cursor has been retrieved from get_events, use this to paginate through all events.
Permission : Team Auditing.

URL Structure
https://api.dropboxapi.com/2/team_log/get_events/continue
Authentication
Team Authentication
Endpoint format
RPC
Example
Get access token for:
curl -X POST https://api.dropboxapi.com/2/team_log/get_events/continue \
    --header "Authorization: Bearer " \
    --header "Content-Type: application/json" \
    --data "{\"cursor\": \"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu\"}"
Parameters
{
    "cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"
}
GetTeamEventsContinueArg
cursor String Indicates from what point to get the next set of events.
Returns
{
    "events": [
        {
            "timestamp": "2017-01-25T15:51:30Z",
            "event_category": {
                ".tag": "tfa"
            },
            "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"
                }
            },
            "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"
            },
            "event_type": {
                ".tag": "shared_content_download",
                "description": "(sharing) Downloaded the shared file or folder."
            },
            "details": {
                ".tag": "shared_content_download_details",
                "shared_content_link": "abc",
                "target_asset_index": 3,
                "sharing_permission": "abc"
            },
            "origin": {
                "access_method": {
                    ".tag": "end_user",
                    "end_user": {
                        ".tag": "web",
                        "session_id": "dbwsid:123456789012345678901234567890123456789"
                    }
                },
                "geo_location": {
                    "ip_address": "10.1.1.100",
                    "city": "San Francisco",
                    "region": "California",
                    "country": "US"
                }
            },
            "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.
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.
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.
actor ActorLogInfo The entity who actually performed the action.
ActorLogInfo (open union)
The entity who performed the action. The value will be one of the following datatypes. New values may be introduced as our API evolves.
user UserLogInfo The user who did the action.
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(min_length=1)? 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(min_length=1)? 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.
admin UserLogInfo The admin who did the action.
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(min_length=1)? 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(min_length=1)? 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.
app AppLogInfo The application who did the action.
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.
reseller ResellerLogInfo Action done by reseller.
ResellerLogInfo
Reseller information.
reseller_name String Reseller name.
reseller_email String(max_length=255) Reseller email.
dropbox Void Action done by Dropbox.
anonymous Void Anonymous actor.
involve_non_team_member Boolean True if the action involved a non team member either as the actor or as one of the affected users.
context ContextLogInfo The user or team on whose behalf the actor performed the action.
ContextLogInfo (open union)
The primary entity on which the action was done. The value will be one of the following datatypes. New values may be introduced as our API evolves.
team_member TeamMemberLogInfo Action was done on behalf of a team member.
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(min_length=1)? 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 Action was done on behalf of a non team member.
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(min_length=1)? 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.
anonymous Void Anonymous context.
team Void Action was done on behalf of the team.
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 an app for team.
AppLinkTeamType
description String
app_link_user AppLinkUserType (apps) Linked an app for team member.
AppLinkUserType
description String
app_unlink_team AppUnlinkTeamType (apps) Unlinked an app for team.
AppUnlinkTeamType
description String
app_unlink_user AppUnlinkUserType (apps) Unlinked an app for team member.
AppUnlinkUserType
description String
file_add_comment FileAddCommentType (comments) Added a 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 a file comment.
FileDeleteCommentType
description String
file_like_comment FileLikeCommentType (comments) Liked a file comment. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
FileLikeCommentType
description String
file_resolve_comment FileResolveCommentType (comments) Resolved a file comment.
FileResolveCommentType
description String
file_unlike_comment FileUnlikeCommentType (comments) Unliked a file comment. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
FileUnlikeCommentType
description String
file_unresolve_comment FileUnresolveCommentType (comments) Unresolved a file comment.
FileUnresolveCommentType
description String
device_change_ip_desktop DeviceChangeIpDesktopType (devices) IP address associated with active desktop session changed.
DeviceChangeIpDesktopType
description String
device_change_ip_mobile DeviceChangeIpMobileType (devices) IP address associated with active mobile session changed.
DeviceChangeIpMobileType
description String
device_change_ip_web DeviceChangeIpWebType (devices) IP address associated with active Web session changed.
DeviceChangeIpWebType
description String
device_delete_on_unlink_fail DeviceDeleteOnUnlinkFailType (devices) Failed to delete all files from an unlinked device.
DeviceDeleteOnUnlinkFailType
description String
device_delete_on_unlink_success DeviceDeleteOnUnlinkSuccessType (devices) Deleted all files from an unlinked device.
DeviceDeleteOnUnlinkSuccessType
description String
device_link_fail DeviceLinkFailType (devices) Failed to link a device.
DeviceLinkFailType
description String
device_link_success DeviceLinkSuccessType (devices) Linked a device.
DeviceLinkSuccessType
description String
device_management_disabled DeviceManagementDisabledType (devices) Disable Device Management. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DeviceManagementDisabledType
description String
device_management_enabled DeviceManagementEnabledType (devices) Enable Device Management. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DeviceManagementEnabledType
description String
device_unlink DeviceUnlinkType (devices) Disconnected a device.
DeviceUnlinkType
description String
emm_refresh_auth_token EmmRefreshAuthTokenType (devices) Refreshed the auth token used for setting up enterprise mobility management.
EmmRefreshAuthTokenType
description String
account_capture_change_availability AccountCaptureChangeAvailabilityType (domains) Granted or revoked the option to enable account capture on domains belonging to the team.
AccountCaptureChangeAvailabilityType
description String
account_capture_migrate_account AccountCaptureMigrateAccountType (domains) Account captured user migrated their account to the team.
AccountCaptureMigrateAccountType
description String
account_capture_relinquish_account AccountCaptureRelinquishAccountType (domains) Account captured user relinquished their account by changing the email address associated with it.
AccountCaptureRelinquishAccountType
description String
disabled_domain_invites DisabledDomainInvitesType (domains) Disabled domain invites. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DisabledDomainInvitesType
description String
domain_invites_approve_request_to_join_team DomainInvitesApproveRequestToJoinTeamType (domains) Approved a member's request to join the team.
DomainInvitesApproveRequestToJoinTeamType
description String
domain_invites_decline_request_to_join_team DomainInvitesDeclineRequestToJoinTeamType (domains) Declined a user's request to join the team.
DomainInvitesDeclineRequestToJoinTeamType
description String
domain_invites_email_existing_users DomainInvitesEmailExistingUsersType (domains) Sent domain invites to existing domain accounts.
DomainInvitesEmailExistingUsersType
description String
domain_invites_request_to_join_team DomainInvitesRequestToJoinTeamType (domains) Asked to join the team.
DomainInvitesRequestToJoinTeamType
description String
domain_invites_set_invite_new_user_pref_to_no DomainInvitesSetInviteNewUserPrefToNoType (domains) Turned off u201cAutomatically invite new usersu201d. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DomainInvitesSetInviteNewUserPrefToNoType
description String
domain_invites_set_invite_new_user_pref_to_yes DomainInvitesSetInviteNewUserPrefToYesType (domains) Turned on u201cAutomatically invite new usersu201d. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
DomainInvitesSetInviteNewUserPrefToYesType
description String
domain_verification_add_domain_fail DomainVerificationAddDomainFailType (domains) Failed to verify a domain belonging to the team.
DomainVerificationAddDomainFailType
description String
domain_verification_add_domain_success DomainVerificationAddDomainSuccessType (domains) Verified a domain belonging to the team.
DomainVerificationAddDomainSuccessType
description String
domain_verification_remove_domain DomainVerificationRemoveDomainType (domains) Removed a domain from the list of verified domains belonging to the team.
DomainVerificationRemoveDomainType
description String
enabled_domain_invites EnabledDomainInvitesType (domains) Enabled domain invites. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
EnabledDomainInvitesType
description String
create_folder CreateFolderType (file_operations) Created folders. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
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) Create a copy reference to a file or 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 a previous version.
FileRevertType
description String
file_rollback_changes FileRollbackChangesType (file_operations) Rolled back file change location changes.
FileRollbackChangesType
description String
file_save_copy_reference FileSaveCopyReferenceType (file_operations) Save a file or folder using a copy reference.
FileSaveCopyReferenceType
description String
file_request_add_deadline FileRequestAddDeadlineType (file_requests) Added a deadline to a file request. This event is replaced by file_request_change and will not be logged going forward.
FileRequestAddDeadlineType
description String
file_request_change FileRequestChangeType (file_requests) Change a file request.
FileRequestChangeType
description String
file_request_change_folder FileRequestChangeFolderType (file_requests) Changed the file request folder. This event is replaced by file_request_change and will not be logged going forward.
FileRequestChangeFolderType
description String
file_request_close FileRequestCloseType (file_requests) Closed a file request.
FileRequestCloseType
description String
file_request_create FileRequestCreateType (file_requests) Created a file request.
FileRequestCreateType
description String
file_request_receive_file FileRequestReceiveFileType (file_requests) Received files for a file request.
FileRequestReceiveFileType
description String
file_request_remove_deadline FileRequestRemoveDeadlineType (file_requests) Removed the file request deadline. This event is replaced by file_request_change and will not be logged going forward.
FileRequestRemoveDeadlineType
description String
file_request_send FileRequestSendType (file_requests) Sent file request to users via email. This event is replaced by file_request_change and will not be logged going forward.
FileRequestSendType
description String
group_add_external_id GroupAddExternalIdType (groups) Added an external ID for group.
GroupAddExternalIdType
description String
group_add_member GroupAddMemberType (groups) Added team members to a group.
GroupAddMemberType
description String
group_change_external_id GroupChangeExternalIdType (groups) Changed the 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 the manager permissions belonging to a group member.
GroupChangeMemberRoleType
description String
group_create GroupCreateType (groups) Created a group.
GroupCreateType
description String
group_delete GroupDeleteType (groups) Deleted a group.
GroupDeleteType
description String
group_moved GroupMovedType (groups) Moved a group. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
GroupMovedType
description String
group_remove_external_id GroupRemoveExternalIdType (groups) Removed the external ID for group.
GroupRemoveExternalIdType
description String
group_remove_member GroupRemoveMemberType (groups) Removed team members from a group.
GroupRemoveMemberType
description String
group_rename GroupRenameType (groups) Renamed a group.
GroupRenameType
description String
emm_error EmmErrorType (logins) Failed to sign in via EMM. This event is replaced by login_fail and will not be logged going forward.
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. This event is replaced by login_fail and will not be logged going forward.
SsoErrorType
description String
member_change_admin_role MemberChangeAdminRoleType (members) Change the admin role belonging to team member.
MemberChangeAdminRoleType
description String
member_change_email MemberChangeEmailType (members) Changed team member email address.
MemberChangeEmailType
description String
member_change_membership_type MemberChangeMembershipTypeType (members) Changed the membership type (limited vs full) for team member. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
MemberChangeMembershipTypeType
description String
member_change_name MemberChangeNameType (members) Changed team member name.
MemberChangeNameType
description String
member_change_status MemberChangeStatusType (members) Changed the membership status of a team member.
MemberChangeStatusType
description String
member_permanently_delete_account_contents MemberPermanentlyDeleteAccountContentsType (members) Permanently deleted contents of a removed team member account.
MemberPermanentlyDeleteAccountContentsType
description String
member_space_limits_change_status MemberSpaceLimitsChangeStatusType (members) Changed the status with respect to whether the team member is under or over storage quota specified by policy.
MemberSpaceLimitsChangeStatusType
description String
member_suggest MemberSuggestType (members) Suggested a new team member to be added to the team.
MemberSuggestType
description String
member_transfer_account_contents MemberTransferAccountContentsType (members) Transferred contents of a removed team member account to another member.
MemberTransferAccountContentsType
description String
paper_content_add_member PaperContentAddMemberType (paper) Added users to the membership of a Paper doc or folder.
PaperContentAddMemberType
description String
paper_content_add_to_folder PaperContentAddToFolderType (paper) Added Paper doc or folder to a folder.
PaperContentAddToFolderType
description String
paper_content_archive PaperContentArchiveType (paper) Archived Paper doc or folder.
PaperContentArchiveType
description String
paper_content_create PaperContentCreateType (paper) Created a Paper doc or folder.
PaperContentCreateType
description String
paper_content_permanently_delete PaperContentPermanentlyDeleteType (paper) Permanently deleted a Paper doc or folder.
PaperContentPermanentlyDeleteType
description String
paper_content_remove_from_folder PaperContentRemoveFromFolderType (paper) Removed Paper doc or folder from a folder.
PaperContentRemoveFromFolderType
description String
paper_content_remove_member PaperContentRemoveMemberType (paper) Removed a user from the membership of a Paper doc or folder.
PaperContentRemoveMemberType
description String
paper_content_rename PaperContentRenameType (paper) Renamed Paper doc or folder.
PaperContentRenameType
description String
paper_content_restore PaperContentRestoreType (paper) Restored an archived Paper doc or folder.
PaperContentRestoreType
description String
paper_doc_add_comment PaperDocAddCommentType (paper) Added a Paper doc comment.
PaperDocAddCommentType
description String
paper_doc_change_member_role PaperDocChangeMemberRoleType (paper) Changed the access type of a Paper doc member.
PaperDocChangeMemberRoleType
description String
paper_doc_change_sharing_policy PaperDocChangeSharingPolicyType (paper) Changed the sharing policy for Paper doc.
PaperDocChangeSharingPolicyType
description String
paper_doc_change_subscription PaperDocChangeSubscriptionType (paper) Followed or unfollowed a Paper doc.
PaperDocChangeSubscriptionType
description String
paper_doc_deleted PaperDocDeletedType (paper) Paper doc archived. This event is deprecated and will not be logged going forward as the associated product functionality no longer exists.
PaperDocDeletedType
description String
paper_doc_delete_comment PaperDocDeleteCommentType (paper) Deleted a Paper doc comment.
PaperDocDeleteCommentType
description String
paper_doc_download PaperDocDownloadType (paper) Downloaded a Paper doc in a particular output format.
PaperDocDo