Dropbox

learn how to connect engini to dropbox using engini’s dropbox activities, you can upload files, download files, create folders, manage files, and automate your document workflows directly from dropbox to get started with the dropbox app, create a free account at dropbox com or sign in with your existing dropbox account getting started with dropbox prerequisites a dropbox account an active api key note make sure to allow the required permissions ( scopes ) in dropbox when connecting your account otherwise, some activities may not work properly add a connection to dropbox in engini enter your engini account at https //app engini io https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking here https //app engini io/connections click on the "new integration" option located at the topbar choose dropbox option from the available applications enter the details in the “add connection” form note there are two different authentication methods available, and the required fields differ depending on the option you choose please follow the relevant instructions for oauth2 method oauth2 sign in using your account connection name enter unique identifier for the connection within engini authentication method select oauth2 click on the “sign in” button sign into your dropbox account fields automatically populated post connecting to a dropbox account include access token a token for authorization to access google services refresh token a token used to obtain a new access token when the current one expires click on the save button to save the connection actions get files or folders retrieves all subfolders and files inside a specified dropbox folder this activity allows you to list the contents of a folder so you can use them in the next steps of your workflow path (from) specifies the dropbox folder whose contents you want to retrieve 3 ways to fill it dynamic value choose through a live, auto generated list of your dropbox folders and subfolders dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" top n limits the number of results returned if left empty, all items are retrieved add filter click add filter to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add filters note the path always need to start with "/", unless you want to retrieve all the folders and files in your account get files continue this action is used to retrieve the next batch of files when a folder contains too many items to be loaded in a single get files or folders request cursor a unique identifier extracted from the output of the previous get files or folders step, telling the system exactly where to resume fetching the remaining files get file the get file activity retrieves detailed information about a specific file in dropbox such as its size, creation date, and version id path specifies the dropbox folder whose contents you want to retrieve 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select the file dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" note the path always need to start with "/" get file request this action retrieves detailed information about a specific "file request" created in the connected dropbox account id specify your file request you have 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox file requests names dynamic mapping map a file request id from a previous steps in your workflow static text provide a file request id get file requests retrieves a list of multiple file requests created in the connected dropbox account, rather than just fetching information about a single one top n limits the number of results returned if left empty, all items are retrieved get file requests continue retrieve the next batch of file requests when the total number of requests in the account exceeds what could be returned in a single get file requests step cursor a unique identifier extracted from the output of the previous get file requests step, letting the system know exactly where to resume listing the remaining file requests get file revisions retrieves the version history (revisions) of a specific file in dropbox it allows you to see metadata for older versions of the file path (from) the specific file path in your dropbox account for which you want to retrieve the version history you have 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" top n the maximum number of past versions to return leaving this field blank defaults to retrieving all available revisions for that file create file request creates a new dropbox file request so others can upload files to a specific folder in your dropbox destination the dropbox folder where uploaded files will be saved for example "/file requests/project documents" 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" title the name of the file request add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields note the path always need to start with "/" delete closed file requests closes a dropbox file request so people can no longer upload files through it i ds \[] a list of file request ids you want to close for example \["oacavmeyrqynkzx9955y", "bf93klmpqr2xyz12345", "xt78abcdef456gh789"] note to delete a file request, it must first be closed dropbox does not allow deleting a request while it is still open if you try to delete a request that is still open, the api will return the error file request open delete file or folder deletes a specific file or an entire folder (including all of its contents) from your connected dropbox account path (from) the explicit dropbox path of the item you wish to remove you have 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" create folder this action creates a new folder at a specified path within your connected dropbox account to help you structure and organize your files path (from) the parent directory where the new folder should be located you have 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" name choose a unique name for this folder add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields download file this activity allows you to get the content of a file in your dropbox app file path specifies the dropbox folder whose contents you want to retrieve 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" note the path always need to start with "/" update file request updates the settings of an existing dropbox file request, such as its title, description, or deadline id the unique identifier of the file request you want to update click on the field to open a dynamic list showing all your file requests names from your dropbox account note you can also manually input a specific id or map it dynamically using the output from a previous activity add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields upload file uploads a file to a specified location in your dropbox account path (from) specifies the dropbox folder whose contents you want to retrieve 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" content insert the content of the file in as a base64 format file name choose a unique name for this file, make sure you write at the end of the the corresponding file type( e g image png, document pdf ) mode choose from the dropdown list if you want to add a new file , overwrite an existing one or update add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields note if you insert the name as " clients/new " it will create a new folder in the path you chose with the title clients and the file name you uploaded is called new move folder or file transfers an existing file or folder from its current location to a new directory within your connected dropbox account from path the current full dropbox path of the file or folder you want to relocate 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/templates/report pdf" to path the exact target destination path where the item should be moved, including the desired item name at the end of the destination path (e g , /archive/report pdf) add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields copy file or folder creates a duplicate copy of an existing file or folder and places it into a new destination path within your connected dropbox account, leaving the original item untouched path (from) the full dropbox path of the original file or folder you want to duplicate 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/templates/report pdf" to path the exact target destination path where the item should be moved, including the desired item name at the end of the destination path (e g , /archive/report pdf) add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields restore file this action reverts an existing file back to a specific older version from its version history path (from) the full dropbox path of the file you want to roll back 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a file path revision the unique id of the specific previous file version you want to restore this id is typically extracted and mapped dynamically from the outputs of a get file revisions step send api request this activity allows you to send a custom api request directly to dropbox base url – this is the root url of the api you’re sending the request to relative url – you can specify additional path segments or parameters that need to be added to the end of the automatically generated url this allows you to customize the specific request you want to perform method – select the http method (e g , get, post, put, delete, patch) body type – defines the format of the data in the body of your request commonly used values include application/json (as shown), which means the body will contain a json formatted payload body – contains any data that is being sent to the server add headers – additional metadata about the request, such as the type of data the engini can accept, the length of the request body, and authentication information add queries – the query refers to the parameters or data that are included in the url of an http request to provide additional information or instructions to the server