Dropbox Connector

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

The Problem with Traditional Dropbox Search

How It Works

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:

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 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:

# Start ingestion
curl -X POST https://api.ragaas.dev/v1/ingest/dropbox \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "conn_123",
    "namespaceId": "ns_123"
  }'

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

5. Search Across Content

Once your content is ingested, you can search across it using our standard search endpoints:

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

Supported File Types

The Dropbox connector supports the following file types:

• Documents:
  • PDF (.pdf)
  • Microsoft Word (.docx)
  • Microsoft PowerPoint (.pptx)
• Text-based formats:
  • CSV (.csv)
  • Text files (.txt)
  • Markdown (.md)

Best Practices

1. File Organization:

   • Keep related files in organized folders
   • Use consistent naming conventions
   • Maintain clear folder hierarchies

2. File Selection:

   • Select specific folders rather than individual files
   • Choose files that are frequently accessed
   • Avoid selecting temporary or redundant files

3. Content Updates:

   • Files are automatically synced every 24 hours
   • Use webhooks for real-time updates
   • Manually trigger syncs for immediate updates

4. Security:

   • Only select files that should be searchable
   • Regularly review connected files
   • Remove unused connections

Rate Limits

• Maximum file size: 50MB
• Maximum files per connection: 10,000
• Maximum concurrent connections: 10
• API rate limits apply as per your plan