{"openapi":"3.0.0","info":{"description":"File storage and sharing"},"servers":[{"description":"File storage and sharing","url":"https://api.apirails.com/dropbox"}],"paths":{"/2/account/set_profile_photo":{"post":{"tags":["Account"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#account-set_profile_photo","api_endpoint":"https://api.dropboxapi.com/2/account/set_profile_photo"},"summary":"Sets a user's profile photo","description":"Sets a user's profile photo","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"photo":{"type":"object","description":"PhotoSourceArg Image to set as the user's new profile photo.","required":true,"properties":{}}}},"example":{"photo":{}}}}}}},"/2/file_properties/properties/add":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-properties-add","api_endpoint":"https://api.dropboxapi.com/2/file_properties/properties/add"},"summary":"Add property groups to a Dropbox file","description":"Add property groups to a Dropbox file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"A unique identifier for the file or folder. (pattern=\"/(.|[\\r\\n])*|id","required":true,"enum":[".*|(ns"]},"property_groups":{"type":"object","description":"List of (PropertyGroup)The property groups which are to be added to a Dropbox file. No two groups in the input should refer to the same template.","required":true,"properties":{}}}},"example":{"path":"","property_groups":{}}}}}}},"/2/file_properties/properties/overwrite":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-properties-overwrite","api_endpoint":"https://api.dropboxapi.com/2/file_properties/properties/overwrite"},"summary":"Overwrite property groups associated with a file","description":"Overwrite property groups associated with a file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"A unique identifier for the file or folder. (pattern=\"/(.|[\\r\\n])*|id","required":true,"enum":[".*|(ns"]},"property_groups":{"type":"object","description":"List of (PropertyGroup; min_items=1)The property groups \"snapshot\" updates to force apply. No two groups in the input should refer to the same template.","required":true,"properties":{}}}},"example":{"path":"","property_groups":{}}}}}}},"/2/file_properties/properties/remove":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-properties-remove","api_endpoint":"https://api.dropboxapi.com/2/file_properties/properties/remove"},"summary":"Permanently removes the specified property group from the file","description":"Permanently removes the specified property group from the file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"A unique identifier for the file or folder. (pattern=\"/(.|[\\r\\n])*|id","required":true,"enum":[".*|(ns"]},"property_template_ids":{"type":"object","description":"List of (String(min_length=1; pattern=\"(/|ptid","required":true,"enum":[").*\"))A list of identifiers for a template created by templates","add_for_user or templates","add_for_team."],"properties":{}}}},"example":{"path":"","property_template_ids":{}}}}}}},"/2/file_properties/properties/search":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-properties-search","api_endpoint":"https://api.dropboxapi.com/2/file_properties/properties/search"},"summary":"Search across property templates for particular property field values","description":"Search across property templates for particular property field values","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"queries":{"type":"object","description":"List of (PropertiesSearchQuery; min_items=1)Queries to search.","required":true,"properties":{}},"template_filter":{"type":"string","description":"TemplateFilter Filter results to contain only properties associated with these template IDs. The default for this union is filter_none.","required":true}}},"example":{"queries":{},"template_filter":""}}}}}},"/2/file_properties/properties/search/continue":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-properties-search-continue","api_endpoint":"https://api.dropboxapi.com/2/file_properties/properties/search/continue"},"summary":"use this to paginate through all search results.","description":"use this to paginate through all search results.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"String(min_length=1)The cursor returned by your last call to properties/search or properties/search/continue.","required":true}}},"example":{"cursor":""}}}}}},"/2/file_properties/properties/update":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-properties-update","api_endpoint":"https://api.dropboxapi.com/2/file_properties/properties/update"},"summary":"Add, update or remove properties associated with the supplied file and templates","description":"Add, update or remove properties associated with the supplied file and templates","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"A unique identifier for the file or folder. (pattern=\"/(.|[\\r\\n])*|id","required":true,"enum":[".*|(ns"]},"update_property_groups":{"type":"object","description":"List of (PropertyGroupUpdate)The property groups \"delta\" updates to apply.","required":true,"properties":{}}}},"example":{"path":"","update_property_groups":{}}}}}}},"/2/file_properties/templates/add_for_user":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-templates-add_for_user","api_endpoint":"https://api.dropboxapi.com/2/file_properties/templates/add_for_user"},"summary":"Add a template associated with a user","description":"Add a template associated with a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"Description for the template. Template descriptions can be up to 1024 bytes.","required":true},"fields":{"type":"object","description":"List of (PropertyFieldTemplate)Definitions of the property fields associated with this template. There can be up to 32 properties in a single template.","required":true,"properties":{}},"name":{"type":"string","description":"Display name for the template. Template names can be up to 256 bytes.","required":true}}},"example":{"description":"","fields":{},"name":""}}}}}},"/2/file_properties/templates/list_for_user":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-templates-list_for_user","api_endpoint":"https://api.dropboxapi.com/2/file_properties/templates/list_for_user"},"summary":"Get the template identifiers for a team","description":"Get the template identifiers for a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/file_properties/templates/remove_for_user":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-templates-remove_for_user","api_endpoint":"https://api.dropboxapi.com/2/file_properties/templates/remove_for_user"},"summary":"Permanently removes the specified template","description":"Permanently removes the specified template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"template_id":{"type":"string","description":"An identifier for a template created by templates/add_for_user or templates/add_for_team (min_length=1 pattern=\"(/|ptid","required":true,"enum":[").*\")."]}}},"example":{"template_id":""}}}}}},"/2/file_properties/templates/update_for_user":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_properties-templates-update_for_user","api_endpoint":"https://api.dropboxapi.com/2/file_properties/templates/update_for_user"},"summary":"Update a template associated with a user","description":"Update a template associated with a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"add_fields":{"type":"object","description":"List of (PropertyFieldTemplate)?Property field templates to be added to the group template. There can be up to 32 properties in a single template.","properties":{}},"description":{"type":"string","description":"Description for the new template. Template descriptions can be up to 1024 bytes."},"name":{"type":"string","description":"A display name for the template. template names can be up to 256 bytes."},"template_id":{"type":"string","description":"An identifier for template added by See templates/add_for_user or templates/add_for_team (min_length=1 pattern=\"(/|ptid","required":true,"enum":[").*\")."]}}},"example":{"add_fields":{},"description":"","name":"","template_id":""}}}}}},"/2/file_properties/templates/get_for_team":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#file_properties-templates-get_for_team","api_endpoint":"https://api.dropboxapi.com/2/file_properties/templates/get_for_team"},"summary":"Get the schema for a specified template","description":"Get the schema for a specified template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"template_id":{"type":"string","description":"An identifier for template added by route See templates/add_for_user or templates/add_for_team (min_length=1; pattern=\"(/|ptid","required":true,"enum":[").*\")."]}}},"example":{"template_id":""}}}}}},"/2/file_properties/templates/remove_for_team":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#file_properties-templates-remove_for_team","api_endpoint":"https://api.dropboxapi.com/2/file_properties/templates/remove_for_team"},"summary":"Permanently removes the specified template created from templates/add_for_user","description":"Permanently removes the specified template created from templates/add_for_user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"template_id":{"type":"string","description":"An identifier for a template created by templates/add_for_user or templates/add_for_team (min_length=1; pattern=\"(/|ptid","required":true,"enum":[").*\")."]}}},"example":{"template_id":""}}}}}},"/2/file_properties/templates/update_for_team":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#file_properties-templates-update_for_team","api_endpoint":"https://api.dropboxapi.com/2/file_properties/templates/update_for_team"},"summary":"Update a template associated with a team","description":"Update a template associated with a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"add_fields":{"type":"object","description":"List of (PropertyFieldTemplate)?Property field templates to be added to the group template. There can be up to 32 properties in a single template.","properties":{}},"description":{"type":"string","description":"Description for the new template. Template descriptions can be up to 1024 bytes."},"name":{"type":"string","description":"A display name for the template. template names can be up to 256 bytes."},"template_id":{"type":"string","description":"An identifier for template added by See templates/add_for_user or templates/add_for_team.","required":true}}},"example":{"add_fields":{},"description":"","name":"","template_id":""}}}}}},"/2/file_properties/templates/add_for_team":{"post":{"tags":["File Properties"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#file_properties-templates-add_for_team","api_endpoint":"https://api.dropboxapi.com/2/file_properties/templates/add_for_team"},"summary":"Add a template associated with a team","description":"Add a template associated with a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"Description for the template. Template descriptions can be up to 1024 bytes.","required":true},"fields":{"type":"object","description":"List of (PropertyFieldTemplate) Definitions of the property fields associated with this template. There can be up to 32 properties in a single template.","required":true,"properties":{}},"name":{"type":"string","description":"Display name for the template. Template names can be up to 256 bytes.","required":true}}},"example":{"description":"","fields":{},"name":""}}}}}},"/2/file_requests/count":{"post":{"tags":["File Request"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_requests-count","api_endpoint":"https://api.dropboxapi.com/2/file_requests/count"},"summary":"Returns the total number of file requests owned by this user","description":"Returns the total number of file requests owned by this user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/file_requests/create":{"post":{"tags":["File Request"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_requests-create","api_endpoint":"https://api.dropboxapi.com/2/file_requests/create"},"summary":"Creates a file request for this user","description":"Creates a file request for this user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"A description of the file request."},"destination":{"type":"string","description":"The path of the folder in the Dropbox where uploaded files will be sent. For apps with the app folder permission; this will be relative to the app folder.\ndeadlineFileRequestDeadline?The deadline for the file request. Deadlines can only be set by Professional and Business accounts. (pattern=\"/(.|[\\r\\n])*\")"},"open":{"type":"boolean","description":"Whether or not the file request should be open. If the file request is closed; it will not accept any file submissions; but it can be opened later","required":true,"enum":[true,false]},"title":{"type":"string","description":"The title of the file request. Must not be empty (min_length=1).","required":true}}},"example":{"description":"","destination":"","open":"","title":""}}}}}},"/2/file_requests/delete":{"post":{"tags":["File Request"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_requests-delete","api_endpoint":"https://api.dropboxapi.com/2/file_requests/delete"},"summary":"Delete a batch of closed file requests","description":"Delete a batch of closed file requests","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"ids":{"type":"object","description":"List of (String(min_length=1; pattern=\"[-_0-9a-zA-Z]+\"))List IDs of the file requests to delete.","required":true,"properties":{}}}},"example":{"ids":{}}}}}}},"/2/file_requests/delete_all_closed":{"post":{"tags":["File Request"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_requests-delete_all_closed","api_endpoint":"https://api.dropboxapi.com/2/file_requests/delete_all_closed"},"summary":"Delete all closed file requests owned by this user","description":"Delete all closed file requests owned by this user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/file_requests/get":{"post":{"tags":["File Request"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_requests-get","api_endpoint":"https://api.dropboxapi.com/2/file_requests/get"},"summary":"Returns the specified file request.","description":"Returns the specified file request.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"The ID of the file request to retrieve (min_length=1; pattern=\"[-_0-9a-zA-Z]+\").","required":true}}},"example":{"id":""}}}}}},"/2/file_requests/list_v2":{"post":{"tags":["File Request"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_requests-list","api_endpoint":"https://api.dropboxapi.com/2/file_requests/list_v2"},"summary":"Returns a list of file requests owned by this user","description":"Returns a list of file requests owned by this user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"limit":{"type":"number","description":"UInt64The maximum number of file requests that should be returned per request. The default for this field is 1000.","required":true}}},"example":{"limit":""}}}}}},"/2/file_requests/list/continue":{"post":{"tags":["File Request"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_requests-list-continue","api_endpoint":"https://api.dropboxapi.com/2/file_requests/list/continue"},"summary":"use this to paginate through all file requests","description":"use this to paginate through all file requests","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"The cursor returned by the previous API call specified in the endpoint description.","required":true}}},"example":{"cursor":""}}}}}},"/2/file_requests/update":{"post":{"tags":["File Request"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#file_requests-update","api_endpoint":"https://api.dropboxapi.com/2/file_requests/update"},"summary":"Update a file request","description":"Update a file request","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"deadline":{"type":"object","description":"UpdateFileRequestDeadlineThe new deadline for the file request. Deadlines can only be set by Professional and Business accounts. The default for this union is no_update.","required":true,"properties":{}},"description":{"type":"string","description":"The description of the file request."},"destination":{"type":"string","description":"(pattern=\"/(.|[\\r\\n])*\")?The new path of the folder in the Dropbox where uploaded files will be sent. For apps with the app folder permission; this will be relative to the app folder."},"id":{"type":"string","description":"The ID of the file request to update. (min_length=1; pattern=\"[-_0-9a-zA-Z]+\")","required":true},"open":{"type":"boolean","description":"Whether to set this file request as open or closed.","enum":[true,false]},"title":{"type":"string","description":"The new title of the file request. Must not be empty. (min_length=1)"}}},"example":{"deadline":{},"description":"","destination":"","id":"","open":"","title":""}}}}}},"/2/files/copy_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-copy","api_endpoint":"https://api.dropboxapi.com/2/files/copy_v2"},"summary":"Copy a file or folder to a different location in the user's Dropbox","description":"Copy a file or folder to a different location in the user's Dropbox","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"allow_ownership_transfer":{"type":"boolean","description":"Allow moves by owner even if it would result in an ownership transfer for the content being moved. This does not apply to copies","required":true,"enum":[true,false]},"autorename":{"type":"boolean","description":"there's a conflict; have the Dropbox server try to autorename the file to avoid the conflict","required":true,"enum":[true,false]},"from_path":{"type":"string","description":"Path in the user's Dropbox to be copied or moved. (pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)|(id"]},"to_path":{"type":"string","description":"Path in the user's Dropbox that is the destination. (pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)|(id"]}}},"example":{"allow_ownership_transfer":"","autorename":"","from_path":"","to_path":""}}}}}},"/2/files/copy_batch_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-copy_batch","api_endpoint":"https://api.dropboxapi.com/2/files/copy_batch_v2"},"summary":"Copy multiple files or folders to different locations at once in the user's Dropbox","description":"Copy multiple files or folders to different locations at once in the user's Dropbox","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"autorename":{"type":"boolean","description":"If there's a conflict with any file; have the Dropbox server try to autorename that file to avoid the conflict","required":true,"enum":[true,false]},"entries":{"type":"object","description":"List of (RelocationPath; min_items=1)List of entries to be moved or copied. Each entry is RelocationPath.","required":true,"properties":{}}}},"example":{"autorename":"","entries":{}}}}}}},"/2/files/copy_batch/check_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-copy_batch-check","api_endpoint":"https://api.dropboxapi.com/2/files/copy_batch/check_v2"},"summary":"Returns the status of an asynchronous job for Files","description":"Returns the status of an asynchronous job for Files","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/files/copy_reference/get":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-copy_reference-get","api_endpoint":"https://api.dropboxapi.com/2/files/copy_reference/get"},"summary":"Get a copy reference to a file or folder","description":"Get a copy reference to a file or folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path to the file or folder you want to get a copy reference to (pattern=\"(/(.|[\\r\\n])*|id","required":true,"enum":[".*)|(rev"]}}},"example":{"path":""}}}}}},"/2/files/copy_reference/save":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-copy_reference-save","api_endpoint":"https://api.dropboxapi.com/2/files/copy_reference/save"},"summary":"Save a copy reference returned by copy_reference/get","description":"Save a copy reference returned by copy_reference/get","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"Path in the user's Dropbox that is the destination (pattern=\"/(.|[\\r\\n])*\").","required":true},"copy_reference":{"type":"string","description":"A copy reference returned by copy_reference/get.","required":true}}},"example":{"path":"","copy_reference":""}}}}}},"/2/files/create_folder_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-create_folder","api_endpoint":"https://api.dropboxapi.com/2/files/create_folder_v2"},"summary":"Create a folder at a given path","description":"Create a folder at a given path","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"Path in the user's Dropbox to create (pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)\")."]},"autorename":{"type":"boolean","description":"If there's a conflict; have the Dropbox server try to autorename the folder to avoid the conflict","required":true,"enum":[true,false]}}},"example":{"path":"","autorename":""}}}}}},"/2/files/create_folder_batch":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-create_folder_batch","api_endpoint":"https://api.dropboxapi.com/2/files/create_folder_batch"},"summary":"Create multiple folders at once","description":"Create multiple folders at once","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"autorename":{"type":"boolean","description":"If there's a conflict; have the Dropbox server try to autorename the folder to avoid the conflict","required":true,"enum":[true,false]},"force_async":{"type":"boolean","description":"Whether to force the create to happen asynchronously","required":true,"enum":[true,false]},"paths":{"type":"object","description":"List of (String(pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)\"); max_items=10000)List of paths to be created in the user's Dropbox. Duplicate path arguments in the batch are considered only once."],"properties":{}}}},"example":{"autorename":"","force_async":"","paths":{}}}}}}},"/2/files/create_folder_batch/check":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-create_folder_batch-check","api_endpoint":"https://api.dropboxapi.com/2/files/create_folder_batch/check"},"summary":"Returns the status of an asynchronous job for create_folder_batch","description":"Returns the status of an asynchronous job for create_folder_batch","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/files/delete_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-delete","api_endpoint":"https://api.dropboxapi.com/2/files/delete_v2"},"summary":"Delete the file or folder at a given path","description":"Delete the file or folder at a given path","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"Path in the user's Dropbox to delete(pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)|(id"]},"parent_rev":{"type":"string","description":"(min_length=9; pattern=\"[0-9a-f]+\")?Perform delete if given \"rev\" matches the existing file's latest \"rev\". This field does not support deleting a folder."}}},"example":{"path":"","parent_rev":""}}}}}},"/2/files/delete_batch":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-delete_batch","api_endpoint":"https://api.dropboxapi.com/2/files/delete_batch"},"summary":"Delete multiple files or folders at once","description":"Delete multiple files/folders at once","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"entries":{"type":"object","description":"List of (DeleteArg).","properties":{}}}},"example":{"entries":{}}}}}}},"/2/files/delete_batch/check":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-delete_batch-check","api_endpoint":"https://api.dropboxapi.com/2/files/delete_batch/check"},"summary":"Returns the status of an asynchronous job for delete_batch","description":"Returns the status of an asynchronous job for delete_batch","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/files/download":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-download","api_endpoint":"https://content.dropboxapi.com/2/files/download"},"summary":"Download a file from a user's Dropbox","description":"Download a file from a user's Dropbox","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path of the file to download (pattern=\"(/(.|[\\r\\n])*|id","required":true,"enum":[".*)|(rev"]}}},"example":{"path":""}}}}}},"/2/files/download_zip":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-download_zip","api_endpoint":"https://content.dropboxapi.com/2/files/download_zip"},"summary":"Download a folder from the user's Dropbox, as a zip file","description":"Download a folder from the user's Dropbox, as a zip file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path of the folder to download (pattern=\"(/(.|[\\r\\n])*|id","required":true,"enum":[".*)|(rev"]}}},"example":{"path":""}}}}}},"/2/files/export":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-export","api_endpoint":"https://content.dropboxapi.com/2/files/export"},"summary":"Export a file from a user's Dropbox","description":"Export a file from a user's Dropbox","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path of the file to be exported (pattern=\"(/(.|[\\r\\n])*|id","required":true,"enum":[".*)|(rev"]},"export_format":{"type":"string","description":"The file format to which the file should be exported. This must be one of the formats listed in the file's export_options returned by get_metadata. If none is specified; the default format (specified in export_as in file metadata) will be used."}}},"example":{"path":"","export_format":""}}}}}},"/2/files/get_file_lock_batch":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-get_file_lock_batch","api_endpoint":"https://api.dropboxapi.com/2/files/get_file_lock_batch"},"summary":"Return the lock metadata for the given list of paths","description":"Return the lock metadata for the given list of paths","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"entries":{"type":"object","description":"List of (LockFileArg)List of 'entries'. Each 'entry' contains a path of the file which will be locked or queried. Duplicate path arguments in the batch are considered only once.","required":true,"properties":{}}}},"example":{"entries":{}}}}}}},"/2/files/get_preview":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-get_preview","api_endpoint":"https://content.dropboxapi.com/2/files/get_preview"},"summary":"Get a preview for a file","description":"Get a preview for a file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path of the file to preview (pattern=\"(/(.|[\\r\\n])*|id","required":true,"enum":[".*)|(rev"]}}},"example":{"path":""}}}}}},"/2/files/get_temporary_link":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-get_temporary_link","api_endpoint":"https://api.dropboxapi.com/2/files/get_temporary_link"},"summary":"Get a temporary link to stream content of a file","description":"Get a temporary link to stream content of a file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path to the file you want a temporary link to (pattern=\"(/(.|[\\r\\n])*|id","required":true,"enum":[".*)|(rev"]}}},"example":{"path":""}}}}}},"/2/files/get_temporary_upload_link":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-get_temporary_upload_link","api_endpoint":"https://api.dropboxapi.com/2/files/get_temporary_upload_link"},"summary":"Get a one-time use temporary upload link to upload a file","description":"Get a one-time use temporary upload link to upload a file ","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"commit_info":{"type":"object","description":"CommitInfo Contains the path and other optional modifiers for the future upload commit. Equivalent to the parameters provided to upload.","required":true,"properties":{}},"duration":{"type":"number","description":"Float64(min=60.0; max=14400.0)How long before this link expires; in seconds. Attempting to start an upload with this link longer than this period of time after link creation will result in an error. The default for this field is 14400.0.","required":true}}},"example":{"commit_info":{},"duration":""}}}}}},"/2/files/get_thumbnail_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-get_thumbnail","api_endpoint":"https://content.dropboxapi.com/2/files/get_thumbnail_v2"},"summary":"Get a thumbnail for an image","description":"Get a thumbnail for an image","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"format":{"type":"string","description":"ThumbnailFormat The format for the thumbnail image; jpeg (default) or png. For images that are photos; jpeg should be preferred; while png is better for screenshots and digital arts. The default for this union is jpeg.","required":true},"mode":{"type":"string","description":"ThumbnailMode How to resize and crop the image to achieve the desired size. The default for this union is strict.","required":true},"resource":{"type":"object","description":"Path Or Link Information specifying which file to preview. This could be a path to a file; a shared link pointing to a file; or a shared link pointing to a folder; with a relative path.","required":true,"properties":{}},"size":{"type":"string","description":"ThumbnailSize The size for the thumbnail image. The default for this union is w64h64.","required":true}}},"example":{"format":"","mode":"","resource":{},"size":""}}}}}},"/2/files/get_thumbnail_batch":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-get_thumbnail_batch","api_endpoint":"https://content.dropboxapi.com/2/files/get_thumbnail_batch"},"summary":"Get thumbnails for a list of images","description":"Get thumbnails for a list of images","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"entries":{"type":"object","description":"List of (ThumbnailArg) List of files to get thumbnails.","required":true,"properties":{}}}},"example":{"entries":{}}}}}}},"/2/files/list_folder":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder","api_endpoint":"https://api.dropboxapi.com/2/files/list_folder"},"summary":"Starts returning the contents of a folder","description":"Starts returning the contents of a folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"A unique identifier for the file (pattern=\"(/(.|[\\r\\n])*)?|id","required":true,"enum":[".*|(ns"]},"include_deleted":{"type":"boolean","description":"If true; the results will include entries for files and folders that used to exist but were deleted","enum":[true,false]},"include_has_explicit_shared_members":{"type":"boolean","description":"If true; the results will include a flag for each file indicating whether or not that file has any explicit members","required":true,"enum":[true,false]},"include_mounted_folders":{"type":"boolean","description":"If true; the results will include entries under mounted folders which includes app folder; shared folder and team folder","required":true,"enum":[true,false]},"include_non_downloadable_files":{"type":"boolean","description":"If true; include files that are not downloadable; i.e. Google Docs","required":true,"enum":[true,false]},"include_property_groups":{"type":"object","description":"TemplateFilterBase?If set to a valid list of template IDs; FileMetadata.property_groups is set if there exists property data associated with the file and each of the listed templates.","properties":{}},"limit":{"type":"number","description":"UInt32(min=1; max=2000)?The maximum number of results to return per request. Note","enum":["This is an approximate number and there can be slightly more entries returned in some cases."]},"recursive":{"type":"boolean","description":"If true; the list folder operation will be applied recursively to all subfolders and the response will contain contents of all subfolders","required":true,"enum":[true,false]},"shared_link":{"type":"object","description":"SharedLink?A shared link to list the contents of. If the link is password-protected; the password must be provided. If this field is present; ListFolderArg.path will be relative to root of the shared link. Only non-recursive mode is supported for shared link.","properties":{}}}},"example":{"path":"","include_deleted":"","include_has_explicit_shared_members":"","include_mounted_folders":"","include_non_downloadable_files":"","include_property_groups":{},"limit":"","recursive":"","shared_link":{}}}}}}},"/2/files/list_folder/continue":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder-continue","api_endpoint":"https://api.dropboxapi.com/2/files/list_folder/continue"},"summary":"use this to paginate through all files and retrieve updates to the folder","description":"use this to paginate through all files and retrieve updates to the folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"The cursor returned by your last call to list_folder or list_folder/continue (min_length=1).","required":true}}},"example":{"cursor":""}}}}}},"/2/files/list_folder/get_latest_cursor":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder-get_latest_cursor","api_endpoint":"https://api.dropboxapi.com/2/files/list_folder/get_latest_cursor"},"summary":"A way to quickly get a cursor for the folder's state","description":"A way to quickly get a cursor for the folder's state","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"A unique identifier for the file (pattern=\"(/(.|[\\r\\n])*)?|id","required":true,"enum":[".*|(ns"]},"include_deleted":{"type":"boolean","description":"If true; the results will include entries for files and folders that used to exist but were deleted","required":true,"enum":[true,false]},"include_has_explicit_shared_members":{"type":"boolean","description":"If true; the results will include a flag for each file indicating whether or not that file has any explicit members","required":true,"enum":[true,false]},"include_mounted_folders":{"type":"boolean","description":"If true; the results will include entries under mounted folders which includes app folder; shared folder and team folder","required":true,"enum":[true,false]},"include_non_downloadable_files":{"type":"boolean","description":"If true; include files that are not downloadable; i.e. Google Docs","required":true,"enum":[true,false]},"include_property_groups":{"type":"object","description":"TemplateFilterBase?If set to a valid list of template IDs; FileMetadata.property_groups is set if there exists property data associated with the file and each of the listed templates.","properties":{}},"limit":{"type":"number","description":"UInt32(min=1; max=2000)?The maximum number of results to return per request. Note","enum":["This is an approximate number and there can be slightly more entries returned in some cases."]},"recursive":{"type":"boolean","description":"If true; the list folder operation will be applied recursively to all subfolders and the response will contain contents of all subfolders","required":true,"enum":[true,false]},"shared_link":{"type":"object","description":"SharedLink?A shared link to list the contents of. If the link is password-protected; the password must be provided. If this field is present; ListFolderArg.path will be relative to root of the shared link. Only non-recursive mode is supported for shared link.","properties":{}}}},"example":{"path":"","include_deleted":"","include_has_explicit_shared_members":"","include_mounted_folders":"","include_non_downloadable_files":"","include_property_groups":{},"limit":"","recursive":"","shared_link":{}}}}}}},"/2/files/list_folder/longpoll":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder-longpoll","api_endpoint":"https://notify.dropboxapi.com/2/files/list_folder/longpoll"},"summary":"A longpoll endpoint to wait for changes on an account","description":"A longpoll endpoint to wait for changes on an account","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"A cursor as returned by list_folder or list_folder/continue (min_length=1). Cursors retrieved by setting ListFolderArg.include_media_info to true are not supported.","required":true},"timeout":{"type":"number","description":"UInt64(min=30; max=480)A timeout in seconds. The request will block for at most this length of time; plus up to 90 seconds of random jitter added to avoid the thundering herd problem. Care should be taken when using this parameter; as some network infrastructure does not support long timeouts. The default for this field is 30.","required":true}}},"example":{"cursor":"","timeout":""}}}}}},"/2/files/list_revisions":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-list_revisions","api_endpoint":"https://api.dropboxapi.com/2/files/list_revisions"},"summary":"Returns revisions for files based on a file path or a file id","description":"Returns revisions for files based on a file path or a file id","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path to the file you want to see the revisions of (pattern=\"/(.|[\\r\\n])*|id","required":true,"enum":[".*|(ns"]},"limit":{"type":"number","description":"UInt64(min=1; max=100)The maximum number of revision entries returned. The default for this field is 10.","required":true},"mode":{"type":"string","description":"ListRevisionsMode Determines the behavior of the API in listing the revisions for a given file path or id. The default for this union is path.","required":true}}},"example":{"path":"","limit":"","mode":""}}}}}},"/2/files/lock_file_batch":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-lock_file_batch","api_endpoint":"https://api.dropboxapi.com/2/files/lock_file_batch"},"summary":"Lock the files at the given paths","description":"Lock the files at the given paths","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"entries":{"type":"object","description":"List of (LockFileArg)List of 'entries'. Each 'entry' contains a path of the file which will be locked or queried. Duplicate path arguments in the batch are considered only once.","required":true,"properties":{}}}},"example":{"entries":{}}}}}}},"/2/files/move_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-move","api_endpoint":"https://api.dropboxapi.com/2/files/move_v2"},"summary":"Move a file or folder to a different location","description":"Move a file or folder to a different location","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"allow_ownership_transfer":{"type":"boolean","description":"Allow moves by owner even if it would result in an ownership transfer for the content being moved. This does not apply to copies","required":true,"enum":[true,false]},"autorename":{"type":"boolean","description":"If there's a conflict; have the Dropbox server try to autorename the file to avoid the conflict","required":true,"enum":[true,false]},"from_path":{"type":"string","description":"Path in the user's Dropbox to be copied or moved(pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)|(id"]},"to_path":{"type":"string","description":"Path in the user's Dropbox that is the destination(pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)|(id"]}}},"example":{"allow_ownership_transfer":"","autorename":"","from_path":"","to_path":""}}}}}},"/2/files/move_batch_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-move_batch","api_endpoint":"https://api.dropboxapi.com/2/files/move_batch_v2"},"summary":"Move multiple files or folders to different locations at once","description":"Move multiple files or folders to different locations at once ","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"allow_ownership_transfer":{"type":"boolean","description":"Allow moves by owner even if it would result in an ownership transfer for the content being moved. This does not apply to copies","required":true,"enum":[true,false]},"autorename":{"type":"boolean","description":"If there's a conflict with any file; have the Dropbox server try to autorename that file to avoid the conflict","required":true,"enum":[true,false]},"entries":{"type":"object","description":"List of (RelocationPath;p min_items=1)List of entries to be moved or copied. Each entry is RelocationPath.","required":true,"properties":{}}}},"example":{"allow_ownership_transfer":"","autorename":"","entries":{}}}}}}},"/2/files/move_batch/check_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-move_batch-check","api_endpoint":"https://api.dropboxapi.com/2/files/move_batch/check_v2"},"summary":"It returns list of results for each entry","description":"It returns list of results for each entry","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job (min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/files/paper/create":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-paper-create","api_endpoint":"https://api.dropboxapi.com/2/files/paper/create"},"summary":"Creates a new Paper doc with the provided content","description":"Creates a new Paper doc with the provided content","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The fully qualified path to the location in the user's Dropbox where the Paper Doc should be created. This should include the document's title and end with .paper (pattern=\"/(.|[\\r\\n])*\").","required":true},"import_format":{"type":"string","description":"ImportFormat The format of the provided data.","required":true}}},"example":{"path":"","import_format":""}}}}}},"/2/files/paper/update":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-paper-update","api_endpoint":"https://api.dropboxapi.com/2/files/paper/update"},"summary":"Updates an existing Paper doc with the provided content","description":"Updates an existing Paper doc with the provided content","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"Path in the user's Dropbox to update. The path must correspond to a Paper doc or an error will be returned (pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)|(id"]},"doc_update_policy":{"type":"string","description":"PaperDocUpdatePolicy How the provided content should be applied to the doc.","required":true},"import_format":{"type":"string","description":"ImportFormat The format of the provided data.","required":true},"paper_revision":{"type":"number","description":"Int64?The latest doc revision. Required when doc_update_policy is update. This value must match the current revision of the doc or error revision_mismatch will be returned."}}},"example":{"path":"","doc_update_policy":"","import_format":"","paper_revision":""}}}}}},"/2/files/permanently_delete":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-permanently_delete","api_endpoint":"https://api.dropboxapi.com/2/files/permanently_delete"},"summary":"Permanently delete the file or folder at a given path","description":"Permanently delete the file or folder at a given path ","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"Path in the user's Dropbox to delete(pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)|(id"]},"parent_rev":{"type":"string","description":"Perform delete if given \"rev\" matches the existing file's latest \"rev\" (min_length=9; pattern=\"[0-9a-f]+\"). This field does not support deleting a folder."}}},"example":{"path":"","parent_rev":""}}}}}},"/2/files/restore":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-restore","api_endpoint":"https://api.dropboxapi.com/2/files/restore"},"summary":"Restore a specific revision of a file to the given path","description":"Restore a specific revision of a file to the given path","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path to save the restored file (pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)\")."]},"rev":{"type":"string","description":"The revision to restore (min_length=9; pattern=\"[0-9a-f]+\").","required":true}}},"example":{"path":"","rev":""}}}}}},"/2/files/save_url":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-save_url","api_endpoint":"https://api.dropboxapi.com/2/files/save_url"},"summary":"Save the data from a specified URL into a file","description":"Save the data from a specified URL into a file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path in Dropbox where the URL will be saved to(pattern=\"/(.|[\\r\\n])*\").","required":true},"url":{"type":"string","description":"The URL to be saved.","required":true}}},"example":{"path":"","url":""}}}}}},"/2/files/save_url/check_job_status":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-save_url-check_job_status","api_endpoint":"https://api.dropboxapi.com/2/files/save_url/check_job_status"},"summary":"Check the status of a save url job","description":"Check the status of a save_url job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job. This is the value of a response returned from the method that launched the job(min_length=1).","required":true}}},"example":{"async_job_id":""}}}}}},"/2/files/search_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-search","api_endpoint":"https://api.dropboxapi.com/2/files/search_v2"},"summary":"Searches for files and folders","description":"Searches for files and folders","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"match_field_options":{"type":"object","description":"SearchMatchFieldOptions?Options for search results match fields.","properties":{}},"options":{"type":"object","description":"SearchOptions?Options for more targeted search results.","properties":{}},"query":{"type":"string","description":"The string to search for. May match across multiple fields based on the request arguments (max_length=1000).","required":true}}},"example":{"match_field_options":{},"options":{},"query":""}}}}}},"/2/files/search/continue_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-search-continue","api_endpoint":"https://api.dropboxapi.com/2/files/search/continue_v2"},"summary":"Fetches the next page of search results returned from search","description":"Fetches the next page of search results returned from search","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"The cursor returned by your last call to search","required":true,"enum":["2 (min_length=1). Used to fetch the next page of results."]}}},"example":{"cursor":""}}}}}},"/2/files/tags/add":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-tags-add","api_endpoint":"https://api.dropboxapi.com/2/files/tags/add"},"summary":"Add a tag to an item","description":"Add a tag to an item","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"Path to the item to be tagged (pattern=\"/(.|[\\r\\n])*\").","required":true},"tag_text":{"type":"string","description":"The value of the tag to add (min_length=1; max_length=32; pattern=\"[A-Za-z0-9_]+\"). Will be automatically converted to lowercase letters.","required":true}}},"example":{"path":"","tag_text":""}}}}}},"/2/files/tags/get":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-tags-get","api_endpoint":"https://api.dropboxapi.com/2/files/tags/get"},"summary":"Get list of tags assigned to items","description":"Get list of tags assigned to items","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"paths":{"type":"object","description":"List of (String(pattern=\"/(.|[\\r\\n])*\")) Path to the items.","required":true,"properties":{}}}},"example":{"paths":{}}}}}}},"/2/files/tags/remove":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-tags-remove","api_endpoint":"https://api.dropboxapi.com/2/files/tags/remove"},"summary":"Remove a tag from an item","description":"Remove a tag from an item","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"Path to the item to tag(pattern=\"/(.|[\\r\\n])*\").","required":true},"tag_text":{"type":"string","description":"The tag to remove. Will be automatically converted to lowercase letters (min_length=1; max_length=32; pattern=\"[A-Za-z0-9_]+\").","required":true}}},"example":{"path":"","tag_text":""}}}}}},"/2/files/unlock_file_batch":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-unlock_file_batch","api_endpoint":"https://api.dropboxapi.com/2/files/unlock_file_batch"},"summary":"Unlock the files at the given paths","description":"Unlock the files at the given paths","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"entries":{"type":"object","description":"List of (UnlockFileArg) List of 'entries'. Each 'entry' contains a path of the file which will be unlocked. Duplicate path arguments in the batch are considered only once.","required":true,"properties":{}}}},"example":{"entries":{}}}}}}},"/2/files/upload":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-upload","api_endpoint":"https://content.dropboxapi.com/2/files/upload"},"summary":"Create a new file with the contents provided in the request","description":"Create a new file with the contents provided in the request","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"Path in the user's Dropbox to save the file (pattern=\"(/(.|[\\r\\n])*)|(ns","required":true,"enum":["[0-9]+(",".*)?)|(id"]},"autorename":{"type":"boolean","description":"If there's a conflict; as determined by mode; have the Dropbox server try to autorename the file to avoid conflict","required":true,"enum":[true,false]},"client_modified":{"type":"number","description":"Timestamp(format=\"%Y-%m-%dT%H","enum":["%M"]},"mode":{"type":"string","description":"WriteModeSelects what to do if the file already exists. The default for this union is add.","required":true},"mute":{"type":"boolean","description":"Normally; users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true; this tells the clients that this modification shouldn't result in a user notification","required":true,"enum":[true,false]},"property_groups":{"type":"object","description":"List of (PropertyGroup)?List of custom properties to add to file.","properties":{}},"strict_conflict":{"type":"boolean","description":"Be more strict about how each WriteMode detects conflict. For example; always return a conflict error when mode = WriteMode.update and the given \"rev\" doesn't match the existing file's \"rev\"; even if the existing file has been deleted. This also forces a conflict even when the target path refers to a file with identical contents. The default for this field is False.\ncontent_hash String(min_length=64; max_length=64)?A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash; an error will be returned. For more information see our Content hash page.","required":true,"enum":[true,false]}}},"example":{"path":"","autorename":"","client_modified":"","mode":"","mute":"","property_groups":{},"strict_conflict":""}}}}}},"/2/files/upload_session/append_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-upload_session-append","api_endpoint":"https://content.dropboxapi.com/2/files/upload_session/append_v2"},"summary":"Append more data to an upload session","description":"Append more data to an upload session","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"close":{"type":"boolean","description":"If true; the current session will be closed; at which point you won't be able to call upload_session/append","required":true,"enum":[true,false]},"content_hash":{"type":"string","description":"A hash of the file content uploaded in this call (min_length=64; max_length=64). If provided and the uploaded content does not match this hash; an error will be returned. For more information see our Content hash page."},"cursor":{"type":"object","description":"UploadSessionCursor Contains the upload session ID and the offset.","required":true,"properties":{}}}},"example":{"close":"","content_hash":"","cursor":{}}}}}}},"/2/files/upload_session/finish":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-upload_session-finish","api_endpoint":"https://content.dropboxapi.com/2/files/upload_session/finish"},"summary":"Finish an upload session and save the uploaded data to the given file path","description":"Finish an upload session and save the uploaded data to the given file path","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"commit":{"type":"object","description":"CommitInfoContains the path and other optional modifiers for the commit.","required":true,"properties":{}},"content_hash":{"type":"string","description":"A hash of the file content uploaded in this call (min_length=64; max_length=64). If provided and the uploaded content does not match this hash; an error will be returned. For more information see our Content hash page."},"cursor":{"type":"object","description":"UploadSessionCursor Contains the upload session ID and the offset.","required":true,"properties":{}}}},"example":{"commit":{},"content_hash":"","cursor":{}}}}}}},"/2/files/upload_session/finish_batch_v2":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-upload_session-finish_batch","api_endpoint":"https://api.dropboxapi.com/2/files/upload_session/finish_batch_v2"},"summary":"This route helps you commit many files at once into a user's Dropbox","description":"This route helps you commit many files at once into a user's Dropbox","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"entries":{"type":"object","description":"List of (UploadSessionFinishArg; max_items=1000) Commit information for each file in the batch.","required":true,"properties":{}}}},"example":{"entries":{}}}}}}},"/2/files/upload_session/finish_batch/check":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-upload_session-finish_batch-check","api_endpoint":"https://api.dropboxapi.com/2/files/upload_session/finish_batch/check"},"summary":"Returns the status of an asynchronous job for upload_session/finish_batch","description":"Returns the status of an asynchronous job for upload_session/finish_batch","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/files/upload_session/start":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-upload_session-start","api_endpoint":"https://content.dropboxapi.com/2/files/upload_session/start"},"summary":"Upload sessions allow you to upload a single file in one or more requests","description":"Upload sessions allow you to upload a single file in one or more requests","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"close":{"type":"boolean","description":"If true; the current session will be closed at which point you won't be able to call upload_session/append","required":true,"enum":[true,false]},"content_hash":{"type":"string","description":"A hash of the file content uploaded in this call(min_length=64; max_length=64). If provided and the uploaded content does not match this hash; an error will be returned. For more information see our Content hash page."},"session_type":{"type":"string","description":"UploadSessionType? Type of upload session you want to start. If not specified; default is UploadSessionType.sequential. This field is optional.","required":true}}},"example":{"close":"","content_hash":"","session_type":""}}}}}},"/2/files/upload_session/start_batch":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#files-upload_session-start_batch","api_endpoint":"https://api.dropboxapi.com/2/files/upload_session/start_batch"},"summary":"This route starts batch of upload_sessions","description":"This route starts batch of upload_sessions","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"num_sessions":{"type":"number","description":"UInt64(min=1; max=1000)The number of upload sessions to start.","required":true},"session_type":{"type":"string","description":"UploadSessionType?Type of upload session you want to start. If not specified; default is UploadSessionType.sequential."}}},"example":{"num_sessions":"","session_type":""}}}}}},"/2/sharing/add_file_member":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-add_file_member","api_endpoint":"https://api.dropboxapi.com/2/sharing/add_file_member"},"summary":"Adds specified members to a file","description":"Adds specified members to a file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"access_level":{"type":"string","description":"AccessLevel union object; describing what access level we want to give new members. The default for this union is viewer.","required":true},"add_message_as_comment":{"type":"boolean","description":"If the custom message should be added as a comment on the file","required":true,"enum":[true,false]},"custom_message":{"type":"string","description":"Message to send to added members in their invitation."},"file":{"type":"string","description":"File to which to add members (min_length=1; pattern=\"((/|id","required":true,"enum":[").*|nspath"]},"members":{"type":"object","description":"List of (MemberSelector)Members to add. Note that even an email address is given; this may result in a user being directly added to the membership if that email is the user's main account email.","required":true,"properties":{}},"quiet":{"type":"boolean","description":"Whether added members should be notified via email and device notifications of their invitation","required":true,"enum":[true,false]}}},"example":{"access_level":"","add_message_as_comment":"","custom_message":"","file":"","members":{},"quiet":""}}}}}},"/2/sharing/add_folder_member":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-add_folder_member","api_endpoint":"https://api.dropboxapi.com/2/sharing/add_folder_member"},"summary":"Allows an owner or editor of a shared folder to add another member","description":"Allows an owner or editor of a shared folder to add another member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"custom_message":{"type":"string","description":"Optional message to display to added members in their invitation (min_length=1)."},"members":{"type":"object","description":"List of (AddMember)The intended list of members to add. Added members will receive invites to join the shared folder.","required":true,"properties":{}},"quiet":{"type":"boolean","description":"Whether added members should be notified via email and device notifications of their invite","required":true,"enum":[true,false]},"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"custom_message":"","members":{},"quiet":"","shared_folder_id":""}}}}}},"/2/sharing/check_job_status":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-check_job_status","api_endpoint":"https://api.dropboxapi.com/2/sharing/check_job_status"},"summary":"Returns the status of an asynchronous job","description":"Returns the status of an asynchronous job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/check_share_job_status":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-check_share_job_status","api_endpoint":"https://api.dropboxapi.com/check_share_job_status"},"summary":"Returns the status of an asynchronous job for sharing a folder","description":"Returns the status of an asynchronous job for sharing a folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/sharing/create_shared_link_with_settings":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-create_shared_link_with_settings","api_endpoint":"https://api.dropboxapi.com/2/sharing/create_shared_link_with_settings"},"summary":"Create a shared link with custom settings","description":"Create a shared link with custom settings","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path to be shared by the shared link(pattern=\"(/(.|[\\r\\n])*|id","required":true,"enum":[".*)|(rev"]},"settings":{"type":"object","description":"SharedLinkSettings?The requested settings for the newly created shared link.","properties":{}}}},"example":{"path":"","settings":{}}}}}}},"/2/sharing/get_file_metadata":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-get_file_metadata","api_endpoint":"https://api.dropboxapi.com/2/sharing/get_file_metadata"},"summary":"Returns shared file metadata","description":"Returns shared file metadata","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"actions":{"type":"object","description":"List of (FileAction)?A list of `FileAction`s corresponding to `FilePermission`s that should appear in the response's SharedFileMetadata.permissions field describing the actions the authenticated user can perform on the file.","properties":{}},"file":{"type":"string","description":"The file to query(min_length=1; pattern=\"((/|id","required":true,"enum":[").*|nspath"]}}},"example":{"actions":{},"file":""}}}}}},"/2/sharing/get_folder_metadata":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-get_folder_metadata","api_endpoint":"https://api.dropboxapi.com/2/sharing/get_folder_metadata"},"summary":"Returns shared folder metadata by its folder ID","description":"Returns shared folder metadata by its folder ID","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"actions":{"type":"object","description":"List of (FolderAction)?A list of `FolderAction`s corresponding to `FolderPermission`s that should appear in the response's SharedFolderMetadata.permissions field describing the actions the authenticated user can perform on the folder.","properties":{}},"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"actions":{},"shared_folder_id":""}}}}}},"/2/sharing/get_shared_link_file":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-get_shared_link_file","api_endpoint":"https://content.dropboxapi.com/2/sharing/get_shared_link_file"},"summary":"Download the shared link's file from a user's Dropbox","description":"Download the shared link's file from a user's Dropbox","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"If the shared link is to a folder(pattern=\"/(.|[\\r\\n])*\"); this parameter can be used to retrieve the metadata for a specific file or sub-folder in this folder. A relative path should be used."},"link_password":{"type":"string","description":"If the shared link has a password; this parameter can be used."},"url":{"type":"string","description":"URL of the shared link.","required":true}}},"example":{"path":"","link_password":"","url":""}}}}}},"/2/sharing/get_shared_link_metadata":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-get_shared_link_metadata","api_endpoint":"https://api.dropboxapi.com/2/sharing/get_shared_link_metadata"},"summary":"Get the shared link's metadata","description":"Get the shared link's metadata","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"If the shared link is to a folder(pattern=\"/(.|[\\r\\n])*\"); this parameter can be used to retrieve the metadata for a specific file or sub-folder in this folder. A relative path should be used."},"link_password":{"type":"string","description":"If the shared link has a password; this parameter can be used."},"url":{"type":"string","description":"URL of the shared link.","required":true}}},"example":{"path":"","link_password":"","url":""}}}}}},"/2/sharing/list_file_members":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_file_members","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_file_members"},"summary":"Use to obtain the members who have been invited to a file","description":"Use to obtain the members who have been invited to a file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"actions":{"type":"object","description":"List of (MemberAction)?The actions for which to return permissions on a member.","properties":{}},"file":{"type":"string","description":"The file for which you want to see members(min_length=1; pattern=\"((/|id","required":true,"enum":[").*|nspath"]},"include_inherited":{"type":"boolean","description":"Whether to include members who only have access from a parent shared folder","required":true,"enum":[true,false]},"limit":{"type":"number","description":"UInt32(min=1; max=300) Number of members to return max per query. Defaults to 100 if no limit is specified. The default for this field is 100.","required":true}}},"example":{"actions":{},"file":"","include_inherited":"","limit":""}}}}}},"/2/sharing/list_file_members/batch":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_file_members-batch","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_file_members/batch"},"summary":"Get members of multiple files at once","description":"Get members of multiple files at once","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"files":{"type":"object","description":"List of (String(min_length=1; pattern=\"((/|id","required":true,"enum":[").*|nspath"],"properties":{}},"limit":{"type":"number","description":"UInt32(max=20)Number of members to return max per query. Defaults to 10 if no limit is specified. The default for this field is 10.","required":true}}},"example":{"files":{},"limit":""}}}}}},"/2/sharing/list_file_members/continue":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_folder_members-continue","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_file_members/continue"},"summary":"use this to paginate through all shared folder members","description":"use this to paginate through all shared folder members","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"The cursor returned by your last call to list_folder_members or list_folder_members/continue.","required":true}}},"example":{"cursor":""}}}}}},"/2/sharing/list_folder_members":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_folders","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_folder_members"},"summary":"Return the list of all shared folders the current user has access to","description":"Return the list of all shared folders the current user has access to","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"actions":{"type":"object","description":"List of (FolderAction)?A list of `FolderAction`s corresponding to `FolderPermission`s that should appear in the response's SharedFolderMetadata.permissions field describing the actions the authenticated user can perform on the folder.","properties":{}},"limit":{"type":"number","description":"UInt32(min=1; max=1000) The maximum number of results to return per request. The default for this field is 1000.","required":true}}},"example":{"actions":{},"limit":""}}}}}},"/2/sharing/list_folder_members/continue":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_folders-continue","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_folder_members/continue"},"summary":"use this to paginate through all shared folders","description":"use this to paginate through all shared folders","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"The cursor returned by the previous API call specified in the endpoint description.","required":true}}},"example":{"cursor":""}}}}}},"/2/sharing/list_folders":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_mountable_folders","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_folders"},"summary":"Return the list of all shared folders the current user can mount or unmount","description":"Return the list of all shared folders the current user can mount or unmount","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"actions":{"type":"object","description":"List of (FolderAction)?A list of `FolderAction`s corresponding to `FolderPermission`s that should appear in the response's SharedFolderMetadata.permissions field describing the actions the authenticated user can perform on the folder.","properties":{}},"limit":{"type":"number","description":"UInt32(min=1; max=1000) The maximum number of results to return per request. The default for this field is 1000.","required":true}}},"example":{"actions":{},"limit":""}}}}}},"/2/sharing/list_folders/continue":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_mountable_folders-continue","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_folders/continue"},"summary":"use this to paginate through all mountable shared folders","description":"use this to paginate through all mountable shared folders","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"The cursor returned by the previous API call specified in the endpoint description.","required":true}}},"example":{"cursor":""}}}}}},"/2/sharing/list_mountable_folders":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_received_files","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_mountable_folders"},"summary":"Returns a list of all files shared with current user","description":"Returns a list of all files shared with current user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"actions":{"type":"object","description":"List of (FileAction)?A list of `FileAction`s corresponding to `FilePermission`s that should appear in the response's SharedFileMetadata.permissions field describing the actions the authenticated user can perform on the file.","properties":{}},"limit":{"type":"number","description":"UInt32(min=1; max=300) Number of files to return max per query. Defaults to 100 if no limit is specified. The default for this field is 100.","required":true}}},"example":{"actions":{},"limit":""}}}}}},"/2/sharing/list_received_files/continue":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_received_files-continue","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_received_files/continue"},"summary":"Get more results with a cursor from list_received_files","description":"Get more results with a cursor from list_received_files","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Cursor in ListFilesResult.cursor.","required":true}}},"example":{"cursor":""}}}}}},"/2/sharing/list_shared_links":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-list_shared_links","api_endpoint":"https://api.dropboxapi.com/2/sharing/list_shared_links"},"summary":"List shared links of this user","description":"List shared links of this user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"(pattern=\"(/(.|[\\r\\n])*|id","enum":[".*)|(rev"]},"cursor":{"type":"string","description":"The cursor returned by your last call to list_shared_links."},"direct_only":{"type":"boolean","description":"See list_shared_links description.","enum":[true,false]}}},"example":{"path":"","cursor":"","direct_only":""}}}}}},"/2/sharing/modify_shared_link_settings":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-modify_shared_link_settings","api_endpoint":"https://api.dropboxapi.com/2/sharing/modify_shared_link_settings"},"summary":"Modify the shared link's settings","description":"Modify the shared link's settings","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"remove_expiration":{"type":"boolean","description":"If set to true; removes the expiration of the shared link","required":true,"enum":[true,false]},"settings":{"type":"object","description":"SharedLinkSettings Set of settings for the shared link.","required":true,"properties":{}},"url":{"type":"string","description":"URL of the shared link to change its settings.","required":true}}},"example":{"remove_expiration":"","settings":{},"url":""}}}}}},"/2/sharing/mount_folder":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-mount_folder","api_endpoint":"https://api.dropboxapi.com/2/sharing/mount_folder"},"summary":"The current user mounts the designated folder","description":"The current user mounts the designated folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"shared_folder_id":{"type":"string","description":"The ID of the shared folder to mount(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"shared_folder_id":""}}}}}},"/2/sharing/relinquish_file_membership":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-relinquish_file_membership","api_endpoint":"https://api.dropboxapi.com/2/sharing/relinquish_file_membership"},"summary":"The current user relinquishes their membership in the designated file","description":"The current user relinquishes their membership in the designated file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","description":"The path or id for the file(min_length=1; pattern=\"((/|id","required":true,"enum":[").*|nspath"]}}},"example":{"file":""}}}}}},"/2/sharing/relinquish_folder_membership":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-relinquish_folder_membership","api_endpoint":"https://api.dropboxapi.com/2/sharing/relinquish_folder_membership"},"summary":"The current user relinquishes their membership in the designated shared folder","description":"The current user relinquishes their membership in the designated shared folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"leave_a_copy":{"type":"boolean","description":"Keep a copy of the folder's contents upon relinquishing membership. This must be set to false when the folder is within a team folder or another shared folder","required":true,"enum":[true,false]},"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"leave_a_copy":"","shared_folder_id":""}}}}}},"/2/sharing/remove_file_member_2":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-remove_file_member_2","api_endpoint":"https://api.dropboxapi.com/2/sharing/remove_file_member_2"},"summary":"Removes a specified member from the file","description":"Removes a specified member from the file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","description":"File from which to remove members(min_length=1; pattern=\"((/|id","required":true,"enum":[").*|nspath"]},"member":{"type":"object","description":"MemberSelector Member to remove from this file. Note that even if an email is specified; it may result in the removal of a user (not an invitee) if the user's main account corresponds to that email address.","required":true,"properties":{}}}},"example":{"file":"","member":{}}}}}}},"/2/sharing/remove_folder_member":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-remove_folder_member","api_endpoint":"https://api.dropboxapi.com/2/sharing/remove_folder_member"},"summary":"Allows an owner or editor of a shared folder to remove another member","description":"Allows an owner or editor of a shared folder to remove another member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"leave_a_copy":{"type":"boolean","description":"If true; the removed user will keep their copy of the folder after it's unshared; assuming it was mounted. Otherwise; it will be removed from their Dropbox. This must be set to false when removing a group; or when the folder is within a team folder or another shared folder.","required":true,"enum":[true,false]},"member":{"type":"object","description":"MemberSelector The member to remove from the folder.","required":true,"properties":{}},"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"leave_a_copy":"","member":{},"shared_folder_id":""}}}}}},"/2/sharing/revoke_shared_link":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-revoke_shared_link","api_endpoint":"https://api.dropboxapi.com/2/sharing/revoke_shared_link"},"summary":"Revoke a shared link","description":"Revoke a shared link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"url":{"type":"string","description":"URL of the shared link.","required":true}}},"example":{"url":""}}}}}},"/2/sharing/set_access_inheritance":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-set_access_inheritance","api_endpoint":"https://api.dropboxapi.com/2/sharing/set_access_inheritance"},"summary":"Change the inheritance policy of an existing Shared Folder","description":"Change the inheritance policy of an existing Shared Folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"access_inheritance":{"type":"string","description":"AccessInheritance The access inheritance settings for the folder. The default for this union is inherit.","required":true},"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"access_inheritance":"","shared_folder_id":""}}}}}},"/2/sharing/share_folder":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-share_folder","api_endpoint":"https://api.dropboxapi.com/2/sharing/share_folder"},"summary":"Share a folder with collaborators","description":"Share a folder with collaborators","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"path":{"type":"string","description":"The path to the folder to share. If it does not exist","required":true},"access_inheritance":{"type":"string","description":"AccessInheritance The access inheritance settings for the folder. The default for this union is inherit.","required":true},"acl_update_policy":{"type":"string","description":"AclUpdatePolicy Who can add and remove members of this shared folder."},"actions":{"type":"object","description":"List of (FolderAction) A list of `FolderAction`s corresponding to `FolderPermission`s that should appear in the response's SharedFolderMetadata.permissions field describing the actions the authenticated user can perform on the folder.","properties":{}},"force_async":{"type":"boolean","description":"Whether to force the share to happen asynchronously","required":true,"enum":[true,false]},"link_settings":{"type":"object","description":"LinkSettings Settings on the link for this folder.","properties":{}},"member_policy":{"type":"string","description":"MemberPolicy?Who can be a member of this shared folder. Only applicable if the current user is on a team."},"shared_link_policy":{"type":"string","description":"SharedLinkPolicy The policy to apply to shared links created for content inside this shared folder. The current user must be on a team to set this policy to SharedLinkPolicy.members."},"then a new one is created(pattern=\"(/(.|[\\r\\n])*)|(ns":{"type":"[0-9]+(/.*)?)\")."},"viewer_info_policy":{"type":"string","description":"ViewerInfoPolicy Who can enable/disable viewer info for this shared folder."}}},"example":{"path":"","access_inheritance":"","acl_update_policy":"","actions":{},"force_async":"","link_settings":{},"member_policy":"","shared_link_policy":"","then a new one is created(pattern=\"(/(.|[\\r\\n])*)|(ns":"","viewer_info_policy":""}}}}}},"/2/sharing/transfer_folder":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-transfer_folder","api_endpoint":"https://api.dropboxapi.com/2/sharing/transfer_folder"},"summary":"Transfer ownership of a shared folder to a member of the shared folder","description":"Transfer ownership of a shared folder to a member of the shared folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]},"to_dropbox_id":{"type":"string","description":"A account or team member ID to transfer ownership to(min_length=1).","required":true}}},"example":{"shared_folder_id":"","to_dropbox_id":""}}}}}},"/2/sharing/unmount_folder":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-unmount_folder","api_endpoint":"https://api.dropboxapi.com/2/sharing/unmount_folder"},"summary":"The current user unmounts the designated folder","description":"The current user unmounts the designated folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"shared_folder_id":""}}}}}},"/2/sharing/unshare_file":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-unshare_file","api_endpoint":"https://api.dropboxapi.com/2/sharing/unshare_file"},"summary":"Remove all members from this file","description":"Remove all members from this file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","description":"The file to unshare(min_length=1; pattern=\"((/|id","required":true,"enum":[").*|nspath"]}}},"example":{"file":""}}}}}},"/2/sharing/unshare_folder":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-unshare_folder","api_endpoint":"https://api.dropboxapi.com/2/sharing/unshare_folder"},"summary":"Allows a shared folder owner to unshare the folder","description":"Allows a shared folder owner to unshare the folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"leave_a_copy":{"type":"boolean","description":"If true; members of this shared folder will get a copy of this folder after it's unshared. Otherwise; it will be removed from their Dropbox. The current user; who is an owner; will always retain their copy","required":true,"enum":[true,false]},"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"leave_a_copy":"","shared_folder_id":""}}}}}},"/2/sharing/update_file_member":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-update_file_member","api_endpoint":"https://api.dropboxapi.com/2/sharing/update_file_member"},"summary":"Changes a member's access on a shared file","description":"Changes a member's access on a shared file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"access_level":{"type":"string","description":"AccessLevel The new access level for the member.","required":true},"file":{"type":"string","description":"File for which we are changing a member's access(min_length=1; pattern=\"((/|id","required":true,"enum":[").*|nspath"]},"member":{"type":"object","description":"MemberSelector The member whose access we are changing.","required":true,"properties":{}}}},"example":{"access_level":"","file":"","member":{}}}}}}},"/2/sharing/update_folder_member":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-update_folder_member","api_endpoint":"https://api.dropboxapi.com/2/sharing/update_folder_member"},"summary":"Allows an owner or editor of a shared folder to update another member's permissions","description":"Allows an owner or editor of a shared folder to update another member's permissions","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"access_level":{"type":"string","description":"AccessLevel The new access level for member. AccessLevel.owner is disallowed.","required":true},"member":{"type":"object","description":"MemberSelector The member of the shared folder to update. Only the MemberSelector.dropbox_id may be set at this time.","required":true,"properties":{}},"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"access_level":"","member":{},"shared_folder_id":""}}}}}},"/2/sharing/update_folder_policy":{"post":{"tags":["Sharing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#sharing-update_folder_policy","api_endpoint":"https://api.dropboxapi.com/2/sharing/update_folder_policy"},"summary":"Update the sharing policies for a shared folder","description":"Update the sharing policies for a shared folder","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"acl_update_policy":{"type":"string","description":"AclUpdatePolicy Who can add and remove members of this shared folder."},"actions":{"type":"object","description":"List of (FolderAction)?A list of `FolderAction`s corresponding to `FolderPermission`s that should appear in the response's SharedFolderMetadata.permissions field describing the actions the authenticated user can perform on the folder.","properties":{}},"link_settings":{"type":"object","description":"LinkSettings Settings on the link for this folder.","properties":{}},"member_policy":{"type":"string","description":"MemberPolicy?Who can be a member of this shared folder. Only applicable if the current user is on a team."},"shared_folder_id":{"type":"string","description":"The ID for the shared folder(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]},"shared_link_policy":{"type":"string","description":"SharedLinkPolicy The policy to apply to shared links created for content inside this shared folder. The current user must be on a team to set this policy to SharedLinkPolicy.members."},"viewer_info_policy":{"type":"string","description":"ViewerInfoPolicy Who can enable/disable viewer info for this shared folder."}}},"example":{"acl_update_policy":"","actions":{},"link_settings":{},"member_policy":"","shared_folder_id":"","shared_link_policy":"","viewer_info_policy":""}}}}}},"/2/team/devices/list_member_devices":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-devices-list_member_devices","api_endpoint":"https://api.dropboxapi.com/2/team/devices/list_member_devices"},"summary":"List all device sessions of a team's member","description":"List all device sessions of a team's member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"include_desktop_clients":{"type":"boolean","description":"Whether to list linked desktop devices of the team's member","required":true,"enum":[true,false]},"include_mobile_clients":{"type":"boolean","description":"Whether to list linked mobile devices of the team's member","required":true,"enum":[true,false]},"include_web_sessions":{"type":"boolean","description":"Whether to list web sessions of the team's member","required":true,"enum":[true,false]},"team_member_id":{"type":"string","description":"The team's member id.","required":true}}},"example":{"include_desktop_clients":"","include_mobile_clients":"","include_web_sessions":"","team_member_id":""}}}}}},"/2/team/devices/list_members_devices":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-devices-list_members_devices","api_endpoint":"https://api.dropboxapi.com/2/team/devices/list_members_devices"},"summary":"List all device sessions of a team","description":"List all device sessions of a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"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."},"include_desktop_clients":{"type":"boolean","description":"Whether to list desktop clients of the team members","required":true,"enum":[true,false]},"include_mobile_clients":{"type":"boolean","description":"Whether to list mobile clients of the team members","required":true,"enum":[true,false]},"include_web_sessions":{"type":"boolean","description":"Whether to list web sessions of the team members","required":true,"enum":[true,false]}}},"example":{"cursor":"","include_desktop_clients":"","include_mobile_clients":"","include_web_sessions":""}}}}}},"/2/team/devices/revoke_device_session":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-devices-revoke_device_session","api_endpoint":"https://api.dropboxapi.com/2/team/devices/revoke_device_session"},"summary":"Revoke a device session of a team's member","description":"Revoke a device session of a team's member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"desktop_client":{"type":"string","description":"RevokeDesktopClientArg Unlink a linked desktop device.","required":true},"mobile_client":{"type":"string","description":"DeviceSessionArg Unlink a linked mobile device.","required":true},"web_session":{"type":"string","description":"DeviceSessionArg End an active session.","required":true}}},"example":{"desktop_client":"","mobile_client":"","web_session":""}}}}}},"/2/team/devices/revoke_device_session_batch":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-devices-revoke_device_session_batch","api_endpoint":"https://api.dropboxapi.com/2/team/devices/revoke_device_session_batch"},"summary":"Revoke a list of device sessions of team members","description":"Revoke a list of device sessions of team members","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"revoke_devices":{"type":"object","description":"List of (RevokeDeviceSessionArg)","required":true,"properties":{}}}},"example":{"revoke_devices":{}}}}}}},"/2/team/features/get_values":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-features-get_values","api_endpoint":"https://api.dropboxapi.com/2/team/features/get_values"},"summary":"Get the values for one or more featues","description":"Get the values for one or more featues","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"features":{"type":"object","description":"List of (Feature) A list of features in Feature. If the list is empty; this route will return FeaturesGetValuesBatchError.","required":true,"properties":{}}}},"example":{"features":{}}}}}}},"/2/team/get_info":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-get_info","api_endpoint":"https://api.dropboxapi.com/2/team/get_info"},"summary":"Retrieves information about a team","description":"Retrieves information about a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/team/groups/create":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-create","api_endpoint":"https://api.dropboxapi.com/2/team/groups/create"},"summary":"Creates a new, empty group, with a requested name","description":"Creates a new, empty group, with a requested name","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"add_creator_as_owner":{"type":"boolean","description":"Automatically add the creator of the group","required":true,"enum":[true,false]},"group_external_id":{"type":"string","description":"The creator of a team can associate an arbitrary external ID to the group."},"group_management_type":{"type":"string","description":"GroupManagementType Whether the team can be managed by selected users; or only by team admins."},"group_name":{"type":"string","description":"Group name.","required":true}}},"example":{"add_creator_as_owner":"","group_external_id":"","group_management_type":"","group_name":""}}}}}},"/2/team/groups/delete":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-delete","api_endpoint":"https://api.dropboxapi.com/2/team/groups/delete"},"summary":"Deletes a group ,The group is deleted immediately","description":"Deletes a group ,The group is deleted immediately","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"group_external_id":{"type":"string","description":"External ID of the group.","required":true},"group_id":{"type":"string","description":"Group ID.","required":true}}},"example":{"group_external_id":"","group_id":""}}}}}},"/2/team/groups/get_info":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-get_info","api_endpoint":"https://api.dropboxapi.com/2/team/groups/get_info"},"summary":"Retrieves information about one or more groups","description":"Retrieves information about one or more groups","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"group_external_ids":{"type":"object","description":"List of (String) List of external IDs of groups.","required":true,"properties":{}},"group_ids":{"type":"object","description":"List of (String) List of group IDs.","required":true,"properties":{}}}},"example":{"group_external_ids":{},"group_ids":{}}}}}}},"/2/team/groups/job_status/get":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-job_status-get","api_endpoint":"https://api.dropboxapi.com/2/team/groups/job_status/get"},"summary":"use this method to poll the status of granting/revoking group members' access to group-owned resources","description":"use this method to poll the status of granting/revoking group members' access to group-owned resources","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/team/groups/list":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-list","api_endpoint":"https://api.dropboxapi.com/2/team/groups/list"},"summary":"Lists groups on a team","description":"Lists groups on a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"limit":{"type":"number","description":"UInt32(min=1; max=1000)Number of results to return per call. The default for this field is 1000.","required":true}}},"example":{"limit":""}}}}}},"/2/team/groups/list/continue":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-list-continue","api_endpoint":"https://api.dropboxapi.com/2/team/groups/list/continue"},"summary":"retrieved from groups/list, use this to paginate through all groups","description":"retrieved from groups/list, use this to paginate through all groups","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Indicates from what point to get the next set of groups.","required":true}}},"example":{"cursor":""}}}}}},"/2/team/groups/members/add":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-members-add","api_endpoint":"https://api.dropboxapi.com/2/team/groups/members/add"},"summary":"Adds members to a group. The members are added immediately","description":"Adds members to a group. The members are added immediately","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"group":{"type":"object","description":"GroupSelectorGroup to which users will be added.","required":true,"properties":{}},"members":{"type":"object","description":"List of (MemberAccess) List of users to be added to the group.","required":true,"properties":{}},"return_members":{"type":"boolean","description":"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","required":true,"enum":[true,false]}}},"example":{"group":{},"members":{},"return_members":""}}}}}},"/2/team/groups/members/list":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-members-list","api_endpoint":"https://api.dropboxapi.com/2/team/groups/members/list"},"summary":"Lists members of a group. Permission : Team Information","description":"Lists members of a group. Permission : Team Information","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"group":{"type":"object","description":"GroupSelectorThe group whose members are to be listed.","required":true,"properties":{}},"limit":{"type":"number","description":"UInt32(min=1; max=1000)Number of results to return per call. The default for this field is 1000.","required":true}}},"example":{"group":{},"limit":""}}}}}},"/2/team/groups/members/list/continue":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-members-list-continue","api_endpoint":"https://api.dropboxapi.com/2/team/groups/members/list/continue"},"summary":"use this to paginate through all members of the group","description":"use this to paginate through all members of the group","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Indicates from what point to get the next set of groups.","required":true}}},"example":{"cursor":""}}}}}},"/2/team/groups/members/remove":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-members-remove","api_endpoint":"https://api.dropboxapi.com/2/team/groups/members/remove"},"summary":"Removes members from a group. The members are removed immediately","description":"Removes members from a group. The members are removed immediately","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"group":{"type":"object","description":"GroupSelector Group from which users will be removed.","required":true,"properties":{}},"return_members":{"type":"boolean","description":"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","required":true,"enum":[true,false]},"users":{"type":"object","description":"List of (UserSelectorArg) List of users to be removed from the group.","required":true,"properties":{}}}},"example":{"group":{},"return_members":"","users":{}}}}}}},"/2/team/groups/members/set_access_type":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-members-set_access_type","api_endpoint":"https://api.dropboxapi.com/2/team/groups/members/set_access_type"},"summary":"Sets a member's access type in a group","description":"Sets a member's access type in a group","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"access_type":{"type":"string","description":"GroupAccessType New group access type the user will have.","required":true},"group":{"type":"object","description":"GroupSelector Specify a group.","required":true,"properties":{}},"return_members":{"type":"boolean","description":"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","required":true,"enum":[true,false]},"user":{"type":"object","description":"UserSelectorArg Identity of a user that is a member of group.","required":true,"properties":{}}}},"example":{"access_type":"","group":{},"return_members":"","user":{}}}}}}},"/2/team/groups/update":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-groups-update","api_endpoint":"https://api.dropboxapi.com/2/team/groups/update"},"summary":"Updates a group's name and/or external ID","description":"Updates a group's name and/or external ID","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"group":{"type":"object","description":"GroupSelector Specify a group.","required":true,"properties":{}},"new_group_external_id":{"type":"string","description":"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."},"new_group_management_type":{"type":"string","description":"GroupManagementType Set new group management type; if provided."},"new_group_name":{"type":"string","description":"Optional argument. Set group name to this if provided."},"return_members":{"type":"boolean","description":"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","required":true,"enum":[true,false]}}},"example":{"group":{},"new_group_external_id":"","new_group_management_type":"","new_group_name":"","return_members":""}}}}}},"/2/team/legal_holds/create_policy":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-legal_holds-create_policy","api_endpoint":"https://api.dropboxapi.com/2/team/legal_holds/create_policy"},"summary":"Creates new legal hold policy","description":"Creates new legal hold policy","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"A description of the legal hold policy (max_length=501)."},"end_date":{"type":"number","description":"Timestamp(format=\"%Y-%m-%dT%H","enum":["%M"]},"members":{"type":"object","description":"List of (String)List of team member IDs added to the hold.","required":true,"properties":{}},"name":{"type":"string","description":"Policy name(max_length=140).","required":true},"start_date":{"type":"number","description":"Timestamp(format=\"%Y-%m-%dT%H","enum":["%M"]}}},"example":{"description":"","end_date":"","members":{},"name":"","start_date":""}}}}}},"/2/team/legal_holds/get_policy":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-legal_holds-get_policy","api_endpoint":"https://api.dropboxapi.com/2/team/legal_holds/get_policy"},"summary":"Gets a legal hold by Id","description":"Gets a legal hold by Id","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"The legal hold Id(pattern=\"^pid_dbhid","enum":[".+\")."]}}},"example":{"id":""}}}}}},"/2/team/legal_holds/list_held_revisions":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-legal_holds-list_held_revisions","api_endpoint":"https://api.dropboxapi.com/2/team/legal_holds/list_held_revisions"},"summary":"List the file metadata that's under the hold","description":"List the file metadata that's under the hold","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"The legal hold Id(pattern=\"^pid_dbhid","required":true,"enum":[".+\")."]}}},"example":{"id":""}}}}}},"/2/team/legal_holds/list_held_revisions_continue":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-legal_holds-list_held_revisions_continue","api_endpoint":"https://api.dropboxapi.com/2/team/legal_holds/list_held_revisions_continue"},"summary":"Continue listing the file metadata that's under the hold","description":"Continue listing the file metadata that's under the hold","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"The cursor idicates where to continue reading file metadata entries for the next API call (min_length=1). When there are no more entries; the cursor will return none."},"id":{"type":"string","description":"The legal hold Id (pattern=\"^pid_dbhid","required":true,"enum":[".+\")."]}}},"example":{"cursor":"","id":""}}}}}},"/2/team/legal_holds/list_policies":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-legal_holds-list_policies","api_endpoint":"https://api.dropboxapi.com/2/team/legal_holds/list_policies"},"summary":"Lists legal holds on a team.","description":"Lists legal holds on a team.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"include_released":{"type":"boolean","description":"Whether to return holds that were released","required":true,"enum":[true,false]}}},"example":{"include_released":""}}}}}},"/2/team/legal_holds/release_policy":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-legal_holds-release_policy","api_endpoint":"https://api.dropboxapi.com/2/team/legal_holds/release_policy"},"summary":"Releases a legal hold by Id","description":"Releases a legal hold by Id","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"The legal hold Id(pattern=\"^pid_dbhid","required":true,"enum":[".+\")."]}}},"example":{"id":""}}}}}},"/2/team/legal_holds/update_policy":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-legal_holds-update_policy","api_endpoint":"https://api.dropboxapi.com/2/team/legal_holds/update_policy"},"summary":"Updates a legal hold","description":"Updates a legal hold","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"Policy new description(max_length=501)."},"id":{"type":"string","description":"The legal hold Id(pattern=\"^pid_dbhid","required":true,"enum":[".+\")."]},"members":{"type":"object","description":"List of (String)?List of team member IDs to apply the policy on.","properties":{}},"name":{"type":"string","description":"Policy new name(max_length=140)."}}},"example":{"description":"","id":"","members":{},"name":""}}}}}},"/2/team/linked_apps/list_member_linked_apps":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-linked_apps-list_member_linked_apps","api_endpoint":"https://api.dropboxapi.com/2/team/linked_apps/list_member_linked_apps"},"summary":"List all linked applications of the team member","description":"List all linked applications of the team member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"team_member_id":{"type":"string","description":"The team member id.","required":true}}},"example":{"team_member_id":""}}}}}},"/2/team/linked_apps/list_members_linked_apps":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-linked_apps-list_members_linked_apps","api_endpoint":"https://api.dropboxapi.com/2/team/linked_apps/list_members_linked_apps"},"summary":"List all applications linked to the team members' accounts","description":"List all applications linked to the team members' accounts","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"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."}}},"example":{"cursor":""}}}}}},"/2/team/linked_apps/revoke_linked_app":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-linked_apps-revoke_linked_app","api_endpoint":"https://api.dropboxapi.com/2/team/linked_apps/revoke_linked_app"},"summary":"Revoke a linked application of the team member","description":"Revoke a linked application of the team member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"app_id":{"type":"string","description":"The application's unique id.","required":true},"team_member_id":{"type":"string","description":"The unique id of the member owning the device.","required":true}}},"example":{"app_id":"","team_member_id":""}}}}}},"/2/team/linked_apps/revoke_linked_app_batch":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-linked_apps-revoke_linked_app_batch","api_endpoint":"https://api.dropboxapi.com/2/team/linked_apps/revoke_linked_app_batch"},"summary":"Revoke a list of linked applications of the team members","description":"Revoke a list of linked applications of the team members","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"revoke_linked_app":{"type":"object","description":"List of (RevokeLinkedApiAppArg)","required":true,"properties":{}}}},"example":{"revoke_linked_app":{}}}}}}},"/2/team/member_space_limits/excluded_users/add":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-member_space_limits-excluded_users-add","api_endpoint":"https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/add"},"summary":"Add users to member space limits excluded users list","description":"Add users to member space limits excluded users list","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"users":{"type":"object","description":"List of (UserSelectorArg)?List of users to be added/removed.","properties":{}}}},"example":{"users":{}}}}}}},"/2/team/member_space_limits/excluded_users/list":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-member_space_limits-excluded_users-list","api_endpoint":"https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/list"},"summary":"List member space limits excluded users","description":"List member space limits excluded users","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"limit":{"type":"number","description":"UInt32(min=1; max=1000)Number of results to return per call. The default for this field is 1000.","required":true}}},"example":{"limit":""}}}}}},"/2/team/member_space_limits/excluded_users/list/continue":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-member_space_limits-excluded_users-list-continue","api_endpoint":"https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/list/continue"},"summary":"Continue listing member space limits excluded users","description":"Continue listing member space limits excluded users","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Indicates from what point to get the next set of users.","required":true}}},"example":{"cursor":""}}}}}},"/2/team/member_space_limits/excluded_users/remove":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-member_space_limits-excluded_users-remove","api_endpoint":"https://api.dropboxapi.com/2/team/member_space_limits/excluded_users/remove"},"summary":"Remove users from member space limits excluded users list","description":"Remove users from member space limits excluded users list","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"users":{"type":"object","description":"List of (UserSelectorArg)?List of users to be added/removed.","properties":{}}}},"example":{"users":{}}}}}}},"/2/team/member_space_limits/get_custom_quota":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-member_space_limits-get_custom_quota","api_endpoint":"https://api.dropboxapi.com/2/team/member_space_limits/get_custom_quota"},"summary":"Get users custom quota. A maximum of 1000 members can be specified in a single call.","description":"Get users custom quota. A maximum of 1000 members can be specified in a single call.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"users":{"type":"object","description":"List of (UserSelectorArg) List of users.","required":true,"properties":{}}}},"example":{"users":{}}}}}}},"/2/team/member_space_limits/remove_custom_quota":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-member_space_limits-remove_custom_quota","api_endpoint":"https://api.dropboxapi.com/2/team/member_space_limits/remove_custom_quota"},"summary":"Remove users custom quota. A maximum of 1000 members can be specified in a single call","description":"Remove users custom quota. A maximum of 1000 members can be specified in a single call","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"users":{"type":"object","description":"List of (UserSelectorArg) List of users.","required":true,"properties":{}}}},"example":{"users":{}}}}}}},"/2/team/member_space_limits/set_custom_quota":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-member_space_limits-set_custom_quota","api_endpoint":"https://api.dropboxapi.com/2/team/member_space_limits/set_custom_quota"},"summary":"Set users custom quota. Custom quota has to be at least 15GB.","description":"Set users custom quota. Custom quota has to be at least 15GB.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"users_and_quotas":{"type":"object","description":"List of (UserCustomQuotaArg) List of users and their custom quotas.","required":true,"properties":{}}}},"example":{"users_and_quotas":{}}}}}}},"/2/team/members/add_v2":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-add","api_endpoint":"https://api.dropboxapi.com/2/team/members/add_v2"},"summary":"Adds members to a team.","description":"Adds members to a team. ","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"force_async":{"type":"boolean","description":"Whether to force the add to happen asynchronously","required":true,"enum":[true,false]},"new_members":{"type":"object","description":"List of (MemberAddV2Arg) Details of new members to be added to the team.","required":true,"properties":{}}}},"example":{"force_async":"","new_members":{}}}}}}},"/2/team/members/add/job_status/get_v2":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-add-job_status-get","api_endpoint":"https://api.dropboxapi.com/2/team/members/add/job_status/get_v2"},"summary":"Once an async_job_id is returned from members/add:2 , use this to poll the status of the asynchronous request.","description":"Once an async_job_id is returned from members/add:2 , use this to poll the status of the asynchronous request.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job (min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/team/members/delete_profile_photo_v2":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-delete_profile_photo","api_endpoint":"https://api.dropboxapi.com/2/team/members/delete_profile_photo_v2"},"summary":"Deletes a team member's profile photo.","description":"Deletes a team member's profile photo.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"user":{"type":"object","description":"UserSelectorArg Identity of the user whose profile photo will be deleted.","required":true,"properties":{}}}},"example":{"user":{}}}}}}},"/2/team/members/get_available_team_member_roles":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-get_available_team_member_roles","api_endpoint":"https://api.dropboxapi.com/2/team/members/get_available_team_member_roles"},"summary":"Get available TeamMemberRoles for the connected team.","description":"Get available TeamMemberRoles for the connected team. ","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/team/members/get_info_v2":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-get_info","api_endpoint":"https://api.dropboxapi.com/2/team/members/get_info_v2"},"summary":"Returns information about multiple team members.","description":"Returns information about multiple team members.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"members":{"type":"object","description":"List of (UserSelectorArg) List of team members.","required":true,"properties":{}}}},"example":{"members":{}}}}}}},"/2/team/members/list_v2":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-list","api_endpoint":"https://api.dropboxapi.com/2/team/members/list_v2"},"summary":"Lists members of a team.","description":"Lists members of a team.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"include_removed":{"type":"boolean","description":"Whether to return removed members","required":true,"enum":[true,false]},"limit":{"type":"number","description":"UInt32(min=1; max=1000) Number of results to return per call. The default for this field is 1000.","required":true}}},"example":{"include_removed":"","limit":""}}}}}},"/2/team/members/list/continue_v2":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-list-continue","api_endpoint":"https://api.dropboxapi.com/2/team/members/list/continue_v2"},"summary":"Once a cursor has been retrieved from members/list:2 use this to paginate through all team members.","description":"Once a cursor has been retrieved from members/list:2 use this to paginate through all team members.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Indicates from what point to get the next set of members.","required":true}}},"example":{"cursor":""}}}}}},"/2/team/members/move_former_member_files":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-move_former_member_files","api_endpoint":"https://api.dropboxapi.com/2/team/members/move_former_member_files"},"summary":"Moves removed member's files to a different member.","description":"Moves removed member's files to a different member. ","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"transfer_admin_id":{"type":"object","description":"UserSelectorArg Errors during the transfer process will be sent via email to this user.","required":true,"properties":{}},"transfer_dest_id":{"type":"object","description":"UserSelectorArg Files from the deleted member account will be transferred to this user.","required":true,"properties":{}},"user":{"type":"object","description":"UserSelectorArg Identity of user to remove/suspend/have their files moved.","required":true,"properties":{}}}},"example":{"transfer_admin_id":{},"transfer_dest_id":{},"user":{}}}}}}},"/2/team/members/move_former_member_files/job_status/check":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-move_former_member_files-job_status-check","api_endpoint":"https://api.dropboxapi.com/2/team/members/move_former_member_files/job_status/check"},"summary":"Once an async_job_id is returned from members/move_former_member_files , use this to poll the status of the asynchronous request.","description":"Once an async_job_id is returned from members/move_former_member_files , use this to poll the status of the asynchronous request.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/team/members/recover":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-recover","api_endpoint":"https://api.dropboxapi.com/2/team/members/recover"},"summary":"Recover a deleted member.","description":"Recover a deleted member.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"user":{"type":"object","description":"UserSelectorArg Identity of user to recover.","required":true,"properties":{}}}},"example":{"user":{}}}}}}},"/2/team/members/remove":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-remove","api_endpoint":"https://api.dropboxapi.com/2/team/members/remove"},"summary":"Removes a member from a team.","description":"Removes a member from a team.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"keep_account":{"type":"boolean","description":"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","required":true,"enum":[true,false]},"retain_team_shares":{"type":"boolean","description":"If provided; allows removed users to keep access to Dropbox folders (not Dropbox Paper folders) already explicitly shared with them (not via a group) when they are downgraded to a Basic account. Users will not retain access to folders that do not allow external sharing. In order to keep the sharing relationships; the arguments wipe_data should be set to false and keep_account should be set to true","required":true,"enum":[true,false]},"transfer_admin_id":{"type":"object","description":"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.","properties":{}},"transfer_dest_id":{"type":"object","description":"UserSelectorArg?If provided; files from the deleted member account will be transferred to this user.","properties":{}},"user":{"type":"object","description":"UserSelectorArg Identity of user to remove/suspend/have their files moved.","required":true,"properties":{}},"wipe_data":{"type":"boolean","description":"If provided; controls if the user's data will be deleted on their linked devices","required":true,"enum":[true,false]}}},"example":{"keep_account":"","retain_team_shares":"","transfer_admin_id":{},"transfer_dest_id":{},"user":{},"wipe_data":""}}}}}},"/2/team/members/remove/job_status/get":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-remove-job_status-get","api_endpoint":"https://api.dropboxapi.com/2/team/members/remove/job_status/get"},"summary":"Once an async_job_id is returned from members/remove; use this to poll the status of the asynchronous request.","description":"Once an async_job_id is returned from members/remove; use this to poll the status of the asynchronous request.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/team/members/secondary_emails/add":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-secondary_emails-add","api_endpoint":"https://api.dropboxapi.com/2/team/members/secondary_emails/add"},"summary":"Add secondary emails to users.","description":"Add secondary emails to users.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"new_secondary_emails":{"type":"object","description":"List of (UserSecondaryEmailsArg) List of users and secondary emails to add.","required":true,"properties":{}}}},"example":{"new_secondary_emails":{}}}}}}},"/2/team/members/secondary_emails/delete":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-secondary_emails-delete","api_endpoint":"https://api.dropboxapi.com/2/team/members/secondary_emails/delete"},"summary":"Delete secondary emails from users.","description":"Delete secondary emails from users.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"emails_to_delete":{"type":"object","description":"List of (UserSecondaryEmailsArg) List of users and their secondary emails to delete.","required":true,"properties":{}}}},"example":{"emails_to_delete":{}}}}}}},"/2/team/members/secondary_emails/resend_verification_emails":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-secondary_emails-resend_verification_emails","api_endpoint":"https://api.dropboxapi.com/2/team/members/secondary_emails/resend_verification_emails"},"summary":"Resend secondary email verification emails.","description":"Resend secondary email verification emails.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"emails_to_resend":{"type":"object","description":"List of (UserSecondaryEmailsArg) List of users and secondary emails to resend verification emails to.","required":true,"properties":{}}}},"example":{"emails_to_resend":{}}}}}}},"/2/team/members/send_welcome_email":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-send_welcome_email","api_endpoint":"https://api.dropboxapi.com/2/team/members/send_welcome_email"},"summary":"Sends welcome email to pending team member.","description":"Sends welcome email to pending team member.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Email.","required":true},"external_id":{"type":"string","description":"External ID(max_length=64)","required":true},"team_member_id":{"type":"string","description":"Team member ID","required":true}}},"example":{"email":"","external_id":"","team_member_id":""}}}}}},"/2/team/members/set_admin_permissions_v2":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-set_admin_permissions","api_endpoint":"https://api.dropboxapi.com/2/team/members/set_admin_permissions_v2"},"summary":"Updates a team member's permissions.","description":"Updates a team member's permissions.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"new_roles":{"type":"object","description":"List of (String(max_length=128; pattern=\"pid_dbtmr","enum":[".*\"); max_items=1)?The new roles for the member. Send empty list to make user member only. For now; only up to one role is allowed."],"properties":{}},"user":{"type":"object","description":"UserSelectorArg Identity of user whose role will be set.","required":true,"properties":{}}}},"example":{"new_roles":{},"user":{}}}}}}},"/2/team/members/set_profile_v2":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-set_profile","api_endpoint":"https://api.dropboxapi.com/2/team/members/set_profile_v2"},"summary":"Updates a team member's profile.","description":"Updates a team member's profile.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"new_email":{"type":"string","description":"New email for member(max_length=255; pattern=\"^['#&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*\\.[A-Za-z]{2 15}$\")."},"new_external_id":{"type":"string","description":"New external ID for member(max_length=64)."},"new_given_name":{"type":"string","description":"New given name for member(max_length=100; pattern=\"[^/","enum":["?*<>\"|]*\")."]},"new_is_directory_restricted":{"type":"boolean","description":"New value for whether the user is a directory restricted user.","enum":[true,false]},"new_persistent_id":{"type":"string","description":"New persistent ID. This field only available to teams using persistent ID SAML configuration."},"new_surname":{"type":"string","description":"New surname for member(max_length=100; pattern=\"[^/","enum":["?*<>\"|]*\")."]},"user":{"type":"object","description":"UserSelectorArg Identity of user whose profile will be set.","required":true,"properties":{}}}},"example":{"new_email":"","new_external_id":"","new_given_name":"","new_is_directory_restricted":"","new_persistent_id":"","new_surname":"","user":{}}}}}}},"/2/team/members/set_profile_photo_v2":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-set_profile_photo","api_endpoint":"https://api.dropboxapi.com/2/team/members/set_profile_photo_v2"},"summary":"Updates a team member's profile photo.","description":"Updates a team member's profile photo.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"photo":{"type":"object","description":"PhotoSourceArg Image to set as the member's new profile photo.","required":true,"properties":{}},"user":{"type":"object","description":"UserSelectorArg Identity of the user whose profile photo will be set.","required":true,"properties":{}}}},"example":{"photo":{},"user":{}}}}}}},"/2/team/members/suspend":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-suspend","api_endpoint":"https://api.dropboxapi.com/2/team/members/suspend"},"summary":"Suspend a member from a team.","description":"Suspend a member from a team.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"user":{"type":"object","description":"UserSelectorArg Identity of user to remove/suspend/have their files moved.","required":true,"properties":{}},"wipe_data":{"type":"boolean","description":"If provided; controls if the user's data will be deleted on their linked devices","required":true,"enum":[true,false]}}},"example":{"user":{},"wipe_data":""}}}}}},"/2/team/members/unsuspend":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-members-unsuspend","api_endpoint":"https://api.dropboxapi.com/2/team/members/unsuspend"},"summary":"Unsuspend a member from a team.","description":"Unsuspend a member from a team.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"user":{"type":"object","description":"UserSelectorArg Identity of user to unsuspend.","required":true,"properties":{}}}},"example":{"user":{}}}}}}},"/2/team/namespaces/list":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-namespaces-list","api_endpoint":"https://api.dropboxapi.com/2/team/namespaces/list"},"summary":"Returns a list of all team-accessible namespaces.","description":"Returns a list of all team-accessible namespaces.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/team/namespaces/list/continue":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-namespaces-list-continue","api_endpoint":"https://api.dropboxapi.com/2/team/namespaces/list/continue"},"summary":"Once a cursor has been retrieved from namespaces/list; use this to paginate through all team-accessible namespaces. Duplicates may occur in the list.","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.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Indicates from what point to get the next set of team-accessible namespaces.","required":true}}},"example":{"cursor":""}}}}}},"/2/team/sharing_allowlist/add":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-sharing_allowlist-add","api_endpoint":"https://api.dropboxapi.com/2/team/sharing_allowlist/add"},"summary":"Endpoint adds Approve List entries.","description":"Endpoint adds Approve List entries.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"domains":{"type":"object","description":"List of (String)? List of domains represented by valid string representation (RFC-1034/5).","properties":{}},"emails":{"type":"object","description":"List of (String)? List of emails represented by valid string representation (RFC-5322/822).","properties":{}}}},"example":{"domains":{},"emails":{}}}}}}},"/2/team/sharing_allowlist/list":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-sharing_allowlist-list","api_endpoint":"https://api.dropboxapi.com/2/team/sharing_allowlist/list"},"summary":"Lists Approve List entries for given team; from newest to oldest; returning up to `limit` entries at a time.","description":"Lists Approve List entries for given team; from newest to oldest; returning up to `limit` entries at a time.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"limit":{"type":"number","description":"UInt32(min=1; max=1000) The number of entries to fetch at one time. The default for this field is 1000.","required":true}}},"example":{"limit":""}}}}}},"/2/team/sharing_allowlist/list/continue":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-sharing_allowlist-list-continue","api_endpoint":"https://api.dropboxapi.com/2/team/sharing_allowlist/list/continue"},"summary":"Lists entries associated with given team; starting from a the cursor.","description":"Lists entries associated with given team; starting from a the cursor.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"The cursor returned from a previous call to sharing_allowlist/list or sharing_allowlist/list/continue.","required":true}}},"example":{"cursor":""}}}}}},"/2/team/sharing_allowlist/remove":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-sharing_allowlist-remove","api_endpoint":"https://api.dropboxapi.com/2/team/sharing_allowlist/remove"},"summary":"Endpoint removes Approve List entries.","description":"Endpoint removes Approve List entries.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"domains":{"type":"object","description":"List of (String)? List of domains represented by valid string representation (RFC-1034/5).","properties":{}},"emails":{"type":"object","description":"List of (String)? List of emails represented by valid string representation (RFC-5322/822).","properties":{}}}},"example":{"domains":{},"emails":{}}}}}}},"/2/team/team_folder/activate":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-activate","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/activate"},"summary":"Sets an archived team folder's status to active.","description":"Sets an archived team folder's status to active.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"content_sync_settings":{"type":"object","description":"List of (ContentSyncSetting) Sync settings applied to contents of this team folder.","required":true,"properties":{}},"is_team_shared_dropbox":{"type":"boolean","description":"True if this team folder is a shared team root.","required":true,"enum":[true,false]},"name":{"type":"string","description":"The name of the team folder.status TeamFolderStatus The status of the team folder.","required":true},"sync_setting":{"type":"object","description":"SyncSetting The sync setting applied to this team folder.","required":true,"properties":{}},"team_folder_id":{"type":"string","description":"The ID of the team folder (pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"content_sync_settings":{},"is_team_shared_dropbox":"","name":"","sync_setting":{},"team_folder_id":""}}}}}},"/2/team/team_folder/archive":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-archive","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/archive"},"summary":"Sets an active team folder's status to archived and removes all folder and file members. This endpoint cannot be used for teams that have a shared team space.","description":"Sets an active team folder's status to archived and removes all folder and file members. This endpoint cannot be used for teams that have a shared team space.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"force_async_off":{"type":"boolean","description":"Whether to force the archive to happen synchronously","required":true,"enum":[true,false]},"team_folder_id":{"type":"string","description":"The ID of the team folder (pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"force_async_off":"","team_folder_id":""}}}}}},"/2/team/team_folder/archive/check":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-archive-check","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/archive/check"},"summary":"Returns the status of an asynchronous job for archiving a team folder.","description":"Returns the status of an asynchronous job for archiving a team folder.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"async_job_id":{"type":"string","description":"Id of the asynchronous job(min_length=1). This is the value of a response returned from the method that launched the job.","required":true}}},"example":{"async_job_id":""}}}}}},"/2/team/team_folder/create":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-create","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/create"},"summary":"Creates a new; active; team folder with no members. This endpoint can only be used for teams that do not already have a shared team space.","description":"Creates a new; active; team folder with no members. This endpoint can only be used for teams that do not already have a shared team space.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name for the new team folder.","required":true},"sync_setting":{"type":"string","description":"SyncSettingArg? The sync setting to apply to this team folder. Only permitted if the team has team selective sync enabled. This field is optional."}}},"example":{"name":"","sync_setting":""}}}}}},"/2/team/team_folder/get_info":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-get_info","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/get_info"},"summary":"Retrieves metadata for team folders.","description":"Retrieves metadata for team folders.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"team_folder_ids":{"type":"object","description":"List of (String(pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\"); min_items=1) The list of team folder IDs."],"properties":{}}}},"example":{"team_folder_ids":{}}}}}}},"/2/team/team_folder/list":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-list","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/list"},"summary":"Lists all team folders.","description":"Lists all team folders.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"limit":{"type":"number","description":"UInt32(min=1; max=1000) The maximum number of results to return per request. The default for this field is 1000.","required":true}}},"example":{"limit":""}}}}}},"/2/team/team_folder/list/continue":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-list-continue","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/list/continue"},"summary":"Once a cursor has been retrieved from team_folder/list; use this to paginate through all team folders.","description":"Once a cursor has been retrieved from team_folder/list; use this to paginate through all team folders.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Indicates from what point to get the next set of team folders.","required":true}}},"example":{"cursor":""}}}}}},"/2/team/team_folder/permanently_delete":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-permanently_delete","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/permanently_delete"},"summary":"Permanently deletes an archived team folder. This endpoint cannot be used for teams that have a shared team space.","description":"Permanently deletes an archived team folder. This endpoint cannot be used for teams that have a shared team space.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"team_folder_id":{"type":"string","description":"The ID of the team folder (pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"team_folder_id":""}}}}}},"/2/team/team_folder/rename":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-rename","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/rename"},"summary":"Changes an active team folder's name.","description":"Changes an active team folder's name.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"New team folder name.","required":true},"team_folder_id":{"type":"string","description":"The ID of the team folder (pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"name":"","team_folder_id":""}}}}}},"/2/team/team_folder/update_sync_settings":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-update_sync_settings","api_endpoint":"https://api.dropboxapi.com/2/team/team_folder/update_sync_settings"},"summary":"Updates the sync settings on a team folder or its contents. Use of this endpoint requires that the team has team selective sync enabled.","description":"Updates the sync settings on a team folder or its contents. Use of this endpoint requires that the team has team selective sync enabled.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"content_sync_settings":{"type":"object","description":"List of (ContentSyncSettingArg)? Sync settings to apply to contents of this team folder.","properties":{}},"sync_setting":{"type":"string","description":"SyncSettingArg? Sync setting to apply to the team folder itself. Only meaningful if the team folder is not a shared team root."},"team_folder_id":{"type":"string","description":"The ID of the team folder (pattern=\"[-_0-9a-zA-Z","required":true,"enum":["]+\")."]}}},"example":{"content_sync_settings":{},"sync_setting":"","team_folder_id":""}}}}}},"/2/team/token/get_authenticated_admin":{"post":{"tags":["Team"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team-token-get_authenticated_admin","api_endpoint":"https://api.dropboxapi.com/2/team/token/get_authenticated_admin"},"summary":"Returns the member profile of the admin who generated the team access token used to make the call.","description":"Returns the member profile of the admin who generated the team access token used to make the call.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/team_log/get_events":{"post":{"tags":["Team Log"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team_log-get_events","api_endpoint":"https://api.dropboxapi.com/2/team_log/get_events"},"summary":"Retrieves team events.","description":"Retrieves team events.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"category":{"type":"string","description":"EventCategory? Filter the returned events to a single category. Note that category shouldn't be provided together with event_type."},"account_id":{"type":"string","description":"Filter the events by account ID(min_length=40; max_length=40). Return only events with this account_id as either Actor; Context; or Participants."},"event_type":{"type":"string","description":"EventTypeArg? Filter the returned events to a single event type. Note that event_type shouldn't be provided together with category."},"limit":{"type":"number","description":"UInt32(min=1; max=1000) The maximal number of results to return per call. Note that some calls may not return limit number of events; and may even return no events; even with `has_more` set to true. In this case; callers should fetch again using get_events/continue. The default for this field is 1000.","required":true},"time":{"type":"number","description":"TimeRange? Filter by time range."}}},"example":{"category":"","account_id":"","event_type":"","limit":"","time":""}}}}}},"/2/team_log/get_events/continue":{"post":{"tags":["Team Log"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/teams#team_log-get_events-continue","api_endpoint":"https://api.dropboxapi.com/2/team_log/get_events/continue"},"summary":"Once a cursor has been retrieved from get_events; use this to paginate through all events.","description":"Once a cursor has been retrieved from get_events; use this to paginate through all events.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Indicates from what point to get the next set of events.","required":true}}},"example":{"cursor":""}}}}}},"/2/users/features/get_values":{"post":{"tags":["Users"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#users-features-get_values","api_endpoint":"https://api.dropboxapi.com/2/users/features/get_values"},"summary":"Get a list of feature values that may be configured for the current account","description":"Get a list of feature values that may be configured for the current account","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"features":{"type":"object","description":"List of (UserFeature) A list of features in UserFeature. If the list is empty; this route will return UserFeaturesGetValuesBatchError.","required":true,"properties":{}}}},"example":{"features":{}}}}}}},"/2/users/get_account":{"post":{"tags":["Users"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#users-get_account","api_endpoint":"https://api.dropboxapi.com/2/users/get_account"},"summary":"Get information about a user's account","description":"Get information about a user's account","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"account_id":{"type":"string","description":"A user's account identifier(min_length=40; max_length=40).","required":true}}},"example":{"account_id":""}}}}}},"/2/users/get_account_batch":{"post":{"tags":["Users"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#users-get_account_batch","api_endpoint":"https://api.dropboxapi.com/2/users/get_account_batch"},"summary":"Get information about multiple user accounts","description":"Get information about multiple user accounts","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"account_ids":{"type":"object","description":"List of (String(min_length=40; max_length=40); min_items=1) List of user account identifiers. Should not contain any duplicate account IDs.","required":true,"properties":{}}}},"example":{"account_ids":{}}}}}}},"/2/users/get_current_account":{"post":{"tags":["Users"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#users-get_current_account","api_endpoint":"https://api.dropboxapi.com/2/users/get_current_account"},"summary":"Get information about the current user's account","description":"Get information about the current user's account","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/users/get_space_usage":{"post":{"tags":["Users"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#users-get_space_usage","api_endpoint":"https://api.dropboxapi.com/2/users/get_space_usage"},"summary":"Get the space usage information for the current user's account","description":"Get the space usage information for the current user's account","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/contacts/delete_manual_contacts":{"post":{"tags":["Contacts"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#contacts-delete_manual_contacts","api_endpoint":"https://api.dropboxapi.com/2/contacts/delete_manual_contacts"},"summary":"Removes all manually added contacts","description":"Removes all manually added contacts","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/contacts/delete_manual_contacts_batch":{"post":{"tags":["Contacts"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#contacts-delete_manual_contacts_batch","api_endpoint":"https://api.dropboxapi.com/2/contacts/delete_manual_contacts_batch"},"summary":"Removes manually added contacts from the given list","description":"Removes manually added contacts from the given list","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email_addresses":{"type":"object","description":"List of manually added contacts to be deleted.","required":true,"properties":{}}}},"example":{"email_addresses":{}}}}}}},"/2/auth/token/from_oauth1":{"post":{"tags":["Auth"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#auth-token-from_oauth1","api_endpoint":"https://api.dropboxapi.com/2/auth/token/from_oauth1"},"summary":"Create OAuth 2.0 access token from OAuth 1.0 token","description":"Create OAuth 2.0 access token from OAuth 1.0 token","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"oauth1_token":{"type":"string","description":"The OAuth 1.0 access token","required":true},"oauth1_token_secret":{"type":"string","description":"The OAuth 1.0 token secret","required":true}}},"example":{"oauth1_token":"","oauth1_token_secret":""}}}}}},"/2/auth/token/revoke":{"post":{"tags":["Auth"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#auth-token-revoke","api_endpoint":"https://api.dropboxapi.com/2/auth/token/revoke"},"summary":"Revoke access token","description":"Revoke access token","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/check/app":{"post":{"tags":["Check"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#check-app","api_endpoint":"https://api.dropboxapi.com/2/check/app"},"summary":"Check app","description":"Check app","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/check/user":{"post":{"tags":["Check"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#check-user","api_endpoint":"https://api.dropboxapi.com/2/check/user"},"summary":"Check user","description":"Check user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/2/openid/userinfo":{"post":{"tags":["OpenID"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.dropbox.com/developers/documentation/http/documentation#openid-userinfo","api_endpoint":"https://api.dropboxapi.com/2/openid/userinfo"},"summary":"Get OpenID user info","description":"Get OpenID user info","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}