For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Fork this repoGet a demo
  • Docs
    • Welcome
    • Quickstart
    • Concepts
    • Search
    • MCP Server
    • CLI
    • Agent Skills
    • Connect
    • Add New Connector
    • Rate Limits
      • Overview
      • Airtable
      • Apollo
      • Asana
      • Attio
      • Bitbucket
      • Box
      • Calcom
      • Clickup
      • Coda
      • Confluence
      • Ctti
      • Document360
      • Dropbox
      • Fireflies
      • Freshdesk
      • Github
      • Gitlab
      • Gmail
      • Google Calendar
      • Google Docs
      • Google Drive
      • Google Slides
      • Hubspot
      • Intercom
      • Jira
      • Linear
      • Monday
      • Notion
      • Onedrive
      • Onenote
      • Outlook Calendar
      • Outlook Mail
      • Pipedrive
      • Powerpoint
      • Salesforce
      • Servicenow
      • Sharepoint
      • Shopify
      • Slab
      • Slack
      • Slite
      • Stripe
      • Teams
      • Todoist
      • Trello
      • Word
      • Zendesk
      • Zoho Crm
      • Zoom
  • API Reference
LogoLogo
Fork this repoGet a demo
On this page
  • Configuration
  • Authentication
  • Configuration Options
  • Data Models
  • Integrate Airweave with Dropbox APIs on localhost
DocsConnectors

Dropbox

Was this page helpful?
Edit this page
Previous

Fireflies

Next
Built with
Dropbox logo

Dropbox

This connector enables AI agents and RAG systems to retrieve context from Dropbox through Airweave’s unified search layer.

Configuration

Dropbox source connector integrates with the Dropbox API to extract and synchronize files.

Connects to folder structures from your Dropbox account.

It supports downloading and processing files.

View Source Code

Explore the Dropbox connector implementation

Authentication

This connector uses OAuth 2.0 with custom credentials. You need to provide your OAuth application’s Client ID and Client Secret, then complete the OAuth consent flow.

OAuth Setup Required
  1. Create an OAuth application in your provider’s developer console
  2. Enter your Client ID and Client Secret when configuring the connection
  3. Complete the OAuth consent flow

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

DropboxAccountEntity

Schema for Dropbox account-level entities based on the Dropbox API.

Reference: https://www.dropbox.com/developers/documentation/http/documentation#users-get_current_account

FieldTypeDescription
account_idstrDropbox account ID
display_namestrDisplay name for the account
abbreviated_nameOptional[str]Abbreviated form of the person’s name (typically initials)
familiar_nameOptional[str]Locale-dependent name (usually given name in US)
given_nameOptional[str]Also known as first name
surnameOptional[str]Also known as last name or family name
emailOptional[str]The user’s email address
email_verifiedboolWhether the user has verified their email address
disabledboolWhether the user has been disabled
account_typeOptional[str]Type of account (basic, pro, business, etc.)
is_teammateboolWhether this user is a teammate of the current user
is_pairedboolWhether the user has both personal and work accounts linked
team_member_idOptional[str]The user’s unique team member ID (if part of a team)
localeOptional[str]The language that the user specified (IETF language tag)
countryOptional[str]The user’s two-letter country code (ISO 3166-1)
profile_photo_urlOptional[str]URL for the profile photo
referral_linkOptional[str]The user’s referral link
space_usedOptional[int]The user’s total space usage in bytes
space_allocatedOptional[int]The user’s total space allocation in bytes
team_infoOptional[Dict]Information about the team if user is a member
root_infoOptional[Dict]Information about the user’s root namespace
DropboxFolderEntity

Schema for Dropbox folder entities matching the Dropbox API.

Reference: https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder

FieldTypeDescription
idstrDropbox folder ID
namestrFolder name
path_lowerOptional[str]Lowercase full path starting with slash
path_displayOptional[str]Display path with proper casing
sharing_infoOptional[Dict]Sharing information for the folder
read_onlyboolWhether the folder is read-only
traverse_onlyboolWhether the folder can only be traversed
no_accessboolWhether the folder cannot be accessed
property_groupsOptional[List[Dict]]Custom properties and tags
DropboxFileEntity

Schema for Dropbox file entities matching the Dropbox API.

Reference: https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder

FieldTypeDescription
idstrDropbox file ID
namestrFile name
path_lowerOptional[str]Lowercase full path in Dropbox
path_displayOptional[str]Display path with proper casing
revOptional[str]Unique identifier for the file revision
client_modifiedOptional[Any]When file was modified by client
server_modifiedOptional[Any]When file was modified on server
is_downloadableboolWhether file can be downloaded directly
content_hashOptional[str]Dropbox content hash for integrity checks
sharing_infoOptional[Dict]Sharing information for the file
has_explicit_shared_membersOptional[bool]Whether file has explicit shared members

Integrate Airweave with Dropbox APIs on localhost

Airweave will access Dropbox on behalf of your users. You’ll need to have each

Dropbox provides documentation on how to implement OAuth 2.0. This guide will walk you through connecting Dropbox APIs to Airweave when running locally.

  1. Go here to create the “Airweave integration” application

  2. Under Settings, add the Redirect URI. Use the appropriate URL for your environment:

    Production (Airweave Cloud):

    https://api.airweave.ai/source-connections/callback

    Local:

    http://localhost:8001/source-connections/callback

3.Under Permissions, select the following scopes:

account_info.read
files.metadata.read
files.content.read
profile
email
  1. Locate the App key and App secret under Settings. Add these credentials to the dev.integrations.yml file to enable Dropbox API integration.