Dropbox Integration

This guide explains how to connect Dropbox to Supervity, what data is available after connection, how operators can use Dropbox data and actions within workflows, and how to remove the integration when needed.

---

Overview

The Supervity Dropbox integration allows your workspace to securely connect Dropbox as a governed platform capability.

Once connected, operators and workflows can use Dropbox data and actions to automate business processes, retrieve file and folder details, manage cloud storage, and coordinate work across systems.

With the Dropbox integration, Supervity can:

• Access file and folder metadata from your Dropbox account
• Download, upload, update, and delete files
• Create, copy, move, and delete folders
• Search files and folders within your storage
• Create, retrieve, and revoke shared links for assets
• Retrieve user and account information
• Use Dropbox data as context for operators
• Trigger workflows based on cloud storage activity

All Dropbox access is governed through Supervity's security, permissions, and audit controls.

---

Prerequisites

Before connecting Dropbox, ensure you have:

• An active Supervity workspace
• A Dropbox account (Personal, Professional, or Business)
• Permission to authorize applications on your Dropbox account
• Access to the Dropbox storage containing the files and folders you want to use

Depending on your Dropbox plan, some features such as team folders or specific sharing administrative settings may require administrator-level licensing or permissions.

---

Adding the Dropbox Integration

Follow these steps to connect Dropbox to Supervity. If you encounter any issues during setup, refer to the Troubleshooting section of this guide.

Step 1: Open Integrations

1. Log in to Supervity.
2. From the left navigation bar, click the Integrations icon.

This opens the Integrations page, where all available integrations are listed. Connected integrations and available integrations can both be managed from this page.

Step 2: Select Dropbox

1. Locate Dropbox in the available integrations list.
2. Click Connect.

Step 3: Authorize Access

You will be redirected to Dropbox's authorization page.

Review the requested permissions and click Allow to grant Supervity access to your Dropbox account.

• Supervity uses Dropbox's standard OAuth 2.0 authorization flow.
• Your Dropbox password is never shared with or stored by Supervity.

Step 4: Complete Connection

After authorization, you will be redirected back to Supervity.

The Dropbox integration will appear as Connected on the Integrations page. Your workspace can now securely access Dropbox capabilities according to the permissions granted.

Having trouble? See the Troubleshooting section for step-by-step help with common setup issues.

---

How Dropbox Works in Supervity

After connection, Dropbox becomes available as a governed platform tool.

Operators can use Dropbox capabilities when planning and executing tasks, while workflows can automate actions using Dropbox storage.

Common use cases include:

• Retrieving folder structures and file details
• Automatically uploading and downloading assets
• Modifying or replacing file contents
• Managing shared links for customer deliverables
• Moving or organizing files based on business events
• Generating and processing content stored in the cloud
• Synchronizing Dropbox storage with other connected systems

---

Using Dropbox in Operators

Connected Dropbox capabilities become available to operators automatically. Operators determine when Dropbox data or actions are required to complete a task and execute accordingly, while remaining governed by workspace permissions, security controls, and approval policies.

What Operators Can Do with Dropbox

Operators can perform the following actions using Dropbox:

• Get metadata for files and folders
• Upload new files and update existing file contents
• Download files for local processing
• Copy or move files and folders to different locations
• Create and delete folders in the directory structure
• Search for files and folders using text queries
• Generate, retrieve, and revoke shared links for external access
• Retrieve authenticated user account details
• Combine Dropbox storage actions with other connected applications for end-to-end automation

Typical Operator Use Cases

---

Features & Prerequisites

For each Dropbox capability available in Supervity, the following describes the use case and the prerequisites required before use.

Get File Metadata

Use Case: Retrieve metadata (such as size, path, last modified date, etc.) for a specific file in your Dropbox storage.

Prerequisites:

• Dropbox account connected to Supervity
• File must exist and be accessible by the authenticated user account

---

Download File

Use Case: Download the raw content of a file from Dropbox for processing, data extraction, or archiving in workflows.

Prerequisites:

• Dropbox account connected to Supervity
• Target file must exist and be accessible by the authenticated user account

---

Upload File

Use Case: Upload a new file with specified content to a designated path in your Dropbox storage.

Prerequisites:

• Dropbox account connected to Supervity
• Destination folder must exist (or permission to write must be granted)
• File content payload must be provided

---

Update File

Use Case: Update or overwrite the content of an existing file in your Dropbox storage.

Prerequisites:

• Dropbox account connected to Supervity
• Target file must exist at the specified path
• Content payload must be provided for the update process

---

Delete File

Use Case: Remove a file from Dropbox when it is no longer required or has been fully processed.

Prerequisites:

• Dropbox account connected to Supervity
• Target file must exist
• Account must have write permissions to delete content at the target path

---

Copy File

Use Case: Copy a file to another location in your Dropbox storage without removing the original file.

Prerequisites:

• Dropbox account connected to Supervity
• Source file must exist and destination path must be valid
• Write permissions required for the destination location

---

Move File

Use Case: Move a file to another location in your Dropbox storage, removing it from its original path.

Prerequisites:

• Dropbox account connected to Supervity
• Source file must exist and destination path must be valid
• Write permissions required for the source and destination paths

---

Get Folder Metadata

Use Case: Retrieve metadata (such as path, unique ID, sharing status, etc.) for a specific folder.

Prerequisites:

• Dropbox account connected to Supervity
• Folder must exist and be accessible by the authenticated user account

---

List Folder

Use Case: List files and folders within a specified directory path in Dropbox. Useful for directory monitoring and folder auditing.

Prerequisites:

• Dropbox account connected to Supervity
• Target directory must exist and be accessible

---

Create Folder

Use Case: Programmatically create a new folder to maintain directory structures for projects, clients, or audits.

Prerequisites:

• Dropbox account connected to Supervity
• Parent folder path must exist
• Write permissions enabled on the target location

---

Delete Folder

Use Case: Delete a folder and all of its contents from Dropbox when it is no longer needed.

Prerequisites:

• Dropbox account connected to Supervity
• Target folder must exist
• Write permissions required to delete content at the target path

---

Copy Folder

Use Case: Copy an entire folder and all of its contents to another path in Dropbox.

Prerequisites:

• Dropbox account connected to Supervity
• Source folder must exist and destination path must be valid
• Write permissions required for the destination location

---

Move Folder

Use Case: Move a folder and all of its contents to another path in Dropbox, removing it from its original path.

Prerequisites:

• Dropbox account connected to Supervity
• Source folder must exist and destination path must be valid
• Write permissions required for the source and destination locations

---

Search

Use Case: Search for files and folders across your Dropbox storage matching specified query parameters.

Prerequisites:

• Dropbox account connected to Supervity
• Query string must be provided

---

Create Shared Link

Use Case: Create a shared link for a file or folder to enable external or public access.

Prerequisites:

• Dropbox account connected to Supervity
• Target file or folder must exist
• Write permissions required for managing links on the target path

---

Get Shared Link

Use Case: Retrieve shared link information for a specific file or folder.

Prerequisites:

• Dropbox account connected to Supervity
• Target file or folder must exist and have an active shared link

---

Revoke Shared Link

Use Case: Revoke an existing shared link for a file or folder to secure the shared asset.

Prerequisites:

• Dropbox account connected to Supervity
• Active shared link URL must exist and be provided for revocation
• Write permissions required to manage links

---

Get Current Account

Use Case: Retrieve account details (such as account ID, email, name, profile photo, etc.) for the authenticated user for auditing or configuration purposes.

Prerequisites:

• Dropbox account connected to Supervity

---

Permissions Requested

Supervity only requests the permissions required for enabled Dropbox capabilities.

Depending on the features used in your workspace, permissions may include:

Supervity follows least-privilege principles and only accesses data necessary to provide requested functionality.

---

Authentication & Security

The Dropbox integration uses OAuth 2.0 authentication.

Security controls include:

• Encrypted credential storage (AES-256)
• Least-privilege access scopes
• Token refresh and rotation support
• Immediate revocation capabilities
• Workspace-level governance controls
• Complete audit logging
• TLS 1.3 for all API and UI connections

All Dropbox access remains subject to Supervity security policies and role-based permissions.

---

Managing the Integration

View Connection Status

From the left navigation bar, click the Integrations icon.

For Dropbox you can view:

• Connection status
• Granted permissions
• Last usage information
• Associated workflows and operators

Reconnect Dropbox

If Dropbox authorization expires or security policies change:

1. Open the Integrations page from the left navigation bar.
2. Select Dropbox.
3. Click Reconnect.
4. Complete authorization again.

Existing workflows and operators do not need to be recreated.

Removing the Dropbox Integration

You can remove the Dropbox connection from your Supervity workspace at any time directly from within the Supervity platform.

Steps to Remove

1. Log in to Supervity.
2. From the left navigation bar, click the Integrations icon.
3. Locate and select Dropbox from the integrations list.
4. Click Disconnect.
5. Confirm the action when prompted.

Implications of Removal

Once removed:

• Supervity immediately loses all access to your Dropbox account and associated data
• No new Dropbox data will be read or processed after removal
• All active Dropbox connections within your Supervity workspace are terminated
• Scheduled or active workflows that depend on Dropbox will stop executing
• Dropbox-dependent workflow steps will fail safely with clear error messages
• Existing workflow definitions within Supervity are not deleted — only the Dropbox connection is terminated
• Historical execution logs remain available for auditing purposes

Disconnecting Dropbox does not delete workflow definitions, operators, or previously generated outputs.

How Your Data Is Handled After Removal

Data Handling on Removal:

• Supervity immediately loses access to your Dropbox account upon removal
• No new Dropbox data will be collected or processed after disconnection
• Temporary files processed during workflow execution are deleted after execution completes
• Dropbox access tokens and all account-related data are permanently deleted from Supervity's platform within 15 minutes of disconnection — no background access continues after removal

---

Auditing & Observability

All Dropbox activity performed through Supervity is logged.

Audit records include:

• Which operator requested access
• Which workflow executed the action
• Timestamp of execution
• Success or failure status
• Relevant inputs and outputs (redacted when sensitive)

This supports compliance, troubleshooting, governance, and operational visibility.

---

Troubleshooting

If you encounter issues at any stage, refer to the steps below. For issues not covered here, contact the Supervity support team.

Authorization Failed During Setup

Likely Cause: Incorrect Dropbox account used, or insufficient permissions to authorize applications.

Resolution:

1. Ensure you are signed in to the correct Dropbox account.
2. Confirm you have permission to authorize third-party applications on your Dropbox account.
3. Return to Supervity → Integrations → Dropbox and click Connect to retry.
4. If the issue persists, contact your Dropbox account administrator.

---

Dropbox Shows Connected but Data Is Missing

Likely Cause: Required permissions were not granted during authorization, or file paths are inaccessible to the connected user.

Resolution:

1. Verify that all required permissions were accepted during the OAuth authorization step.
2. Confirm that the path you are requesting exists and is accessible to the connected Dropbox account.
3. Verify folder share permissions to ensure the connected user has read/write privileges.
4. Reconnect the integration via Integrations → Dropbox → Reconnect to refresh permissions.

---

Connection Expired or Token Invalid

Likely Cause: OAuth tokens may expire or be revoked by Dropbox.

Resolution:

1. Go to Integrations → Dropbox → Reconnect.
2. Complete the Dropbox authorization flow again.
3. Existing workflows do not need to be reconfigured after reconnection.

---

Workflow Cannot Access Dropbox

Likely Cause: Dropbox may have been disconnected, or workspace governance policies restrict access.

Resolution:

1. Confirm Dropbox is still connected under the Integrations page.
2. Verify the workflow has permission to use Dropbox within your workspace governance settings.
3. Check that workspace policies allow Dropbox execution for the relevant operators or workflows.

---

File Upload or Download Fails

Likely Cause: Large file size limitations, network timeouts, or invalid paths.

Resolution:

1. Confirm the target file path is formatted correctly (e.g., must start with a slash /).
2. Check that your Dropbox storage account has sufficient available space.
3. Verify the file size is within supported ranges.
4. Check execution logs to identify any specific path or permission conflicts.

---

Shared Link Operations Fail

Likely Cause: The file does not exist, or security policies in your Dropbox team account restrict generating public links.

Resolution:

1. Confirm the file or folder is present at the specified path.
2. Check with your Dropbox team administrator to verify that external link sharing is permitted.
3. Verify you are not attempting to generate a link for an asset that already has a shared link.

---

Frequently Asked Questions

Q: Is my Dropbox password shared with or stored by Supervity?

No. Supervity uses Dropbox's standard OAuth 2.0 authorization flow. Your Dropbox password is never shared with or stored by Supervity. Only scoped access tokens are stored, and these are encrypted at rest using AES-256.

---

Q: What Dropbox plan do I need to use all features?

Basic file operations, uploads, downloads, and shared link operations work with standard Dropbox plans. Certain organizational or administrative security properties might require Business or Enterprise plans.

---

Q: Will I need to reconfigure my workflows after reconnecting Dropbox?

No. If you reconnect Dropbox due to token expiry or permission changes, existing workflow definitions and operators do not need to be recreated or reconfigured.

---

Q: What happens to my workflows if I disconnect or remove Dropbox?

Workflow definitions are not deleted when Dropbox is disconnected or removed. However, any workflow steps that depend on Dropbox will fail safely with clear error messages until Dropbox is reconnected.

---

Q: How do I authorize the Supervity Dropbox integration?

Log in to Supervity at Supervity, navigate to the Integrations page from the left navigation bar, locate Dropbox, and click Connect. You will be redirected to Dropbox's authorization page where you can review and approve the requested permissions. After authorization, you will be redirected back to Supervity automatically. See the Adding the Dropbox Integration section above for full step-by-step instructions.

---

Q: Can I limit which Dropbox data Supervity can access?

Supervity requests only the permissions required for enabled capabilities, following least-privilege principles. You can review all requested scopes during the OAuth authorization step before approving.

---

Q: Who do I contact if I have an issue with the integration?

Contact the Supervity support team. See the Support section below for full contact details, support hours, and SLA information.

---

Support

If you need assistance with the Dropbox integration, visit the Support page.

Support Hours

• Monday to Friday, 9:00 AM – 6:00 PM IST
• Requests submitted outside business hours will be addressed on the next business day

First Response SLA

• All support requests receive an initial response within 24 business hours

Contact Information

When Contacting Support, Please Provide

• Workspace name
• Dropbox account used for authorization
• Relevant workflow or operator information
• Error messages or screenshots when available

This helps the support team investigate and resolve issues more quickly.

---

Related Documentation

• Integrations Overview
• OAuth2
• Security & Privacy
• Supervity Website