RAGaaS Logo

Dropbox Connector

Make your Dropbox files searchable with AI. Connect your Dropbox to RAGaaS and instantly search across all your files with semantic understanding.

Common Challenges

  • Basic keyword matching misses context
  • No search across file contents
  • Separate search for each folder
  • Complex API integration
  • Manual file syncing

Our Solution

  • Semantic search understands meaning
  • Full-text search across all files
  • Unified search across folders
  • Simple REST API
  • Automatic content sync

How It Works

1

Set Up Dropbox Integration

Create a Dropbox app and configure OAuth credentials. We'll guide you through the setup process.

2

Select Your Files

Choose which Dropbox files to connect. Our integration respects your permissions and only accesses the files you explicitly select.

3

Start Searching

Use our API to search across your Dropbox content with AI understanding. Perfect for building internal tools, knowledge bases, or search applications.

Implementation Guide

1. Create Dropbox App

First, set up your Dropbox app and configure OAuth:

  1. Go to Dropbox App Console
  2. Click "Create app"
  3. Choose the following settings:
    • Choose API: Scoped access
    • Choose access type: Full Dropbox (for accessing all files) or App folder (for a dedicated folder)
    • Name your app: RAGaaS Integration (or your preferred name)
  4. Under the "Settings" tab:
    • Find the "OAuth 2" section
    • Add redirect URI: https://api.ragaas.dev/connectors/dropbox/callback
    • Note down your app credentials:
      • App key (Client ID)
      • App secret (Client Secret)
  5. Under the "Permissions" tab:
    • Enable the following permissions:
      • account_info.read (view account information)
      • files.metadata.read (view file metadata)
      • files.content.read (view file content)
  6. Back in the "Settings" tab:
    • Scroll to "Chooser / Saver / Embedder domains" section
    • Add ragaas.dev to the allowed domains list
    • Click "Add" to save the domain
    • This enables the Dropbox file picker to work within the RAGaaS application

2. Configure RAGaaS

Add your Dropbox configuration to your RAGaaS namespace:

Configure Dropbox

curl -X PATCH https://api.ragaas.dev/v1/namespaces/ns_123 \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "dropboxConfig": {
      "clientId": "your-dropbox-app-key",
      "clientSecret": "your-dropbox-app-secret"
    }
  }'

3. Create Dropbox Connection

Now create a connection to your Dropbox:

  1. Create a new Dropbox connection to get an authorization URL
  2. Open the URL in a browser for the user to authorize
  3. After authorization, Dropbox redirects back to RAGaaS where:
    • The Dropbox file picker will open
    • User can browse their Dropbox and select files/folders to share
    • Selected files will be connected to RAGaaS for ingestion
  4. Check the connection status - it will be ACTIVE when ready

Create Connection

# Create Dropbox connection
curl -X POST https://api.ragaas.dev/v1/connections/dropbox \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Dropbox",
    "namespaceId": "ns_123"
  }'

# Open authorizationUrl in browser for user to authorize
# User selects files using Dropbox Chooser
# Dropbox redirects back to RAGaaS after file selection

# Check connection status
curl "https://api.ragaas.dev/v1/connections/dropbox?namespaceId=ns_123" \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}"

4. Ingest Dropbox Content

After successfully creating a connection, you can ingest the selected Dropbox files: (docs)

Ingest Content

# Start ingestion
curl -X POST https://api.ragaas.dev/v1/ingest/dropbox \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "namespaceId": "ns_123",
    "ingestConfig": {
      "source": "DROPBOX",
      "config": {
        "connectionId": "your-connection-id",
        "metadata": {
          "source": "dropbox",
          "workspace": "My Workspace"
        }
      }
    }
  }'

# Get the ingestJobRunId from the response

# Check ingestion status
curl "https://api.ragaas.dev/v1/ingest-job-runs/job_xyz789?namespaceId=ns_123" \
 -H "Authorization: Bearer ${RAGAAS_API_KEY}"

5. Search Your Content

Once your ingestion job is complete, you can search across your Dropbox files: (docs)

Search Content

curl -X POST https://api.ragaas.dev/v1/search \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is our refund policy?",
    "namespaceId": "ns_123",
    "filter": {
      "metadata": {
        "source": "dropbox"
      }
    }
  }'

Supported File Types

The Box connector supports the following file types:

  • Documents: .pdf, .doc, .docx, .ppt, .pptx
  • Spreadsheets: .xls, .xlsx, .csv
  • Text files: .txt, .md, .rtf
  • Web files: .html, .xml

Next Steps