Box Connector

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

The Problem with Traditional Box Search

How It Works

Implementation Guide

1. Create Box App

First, set up your Box app and configure OAuth:

1. Go to Box Developer Console
2. Click Create New App
3. In the initial setup:
   • Select Custom App
   • Enter app name: RAGaaS Integration (or your preferred name)
   • Purpose: Integration
   • Categories: Select AI and Core Enterprise
   • External system: Enter RAGaaS (or your company name)
   • Who is building this application: Select Customer
   • Click Next
4. Choose authentication method:
   • Select User Authentication (OAuth 2.0)
5. Under Configuration:
   • Find OAuth 2.0 Redirect URIs and add: https://api.ragaas.dev/connectors/box/callback
   • Note down your app credentials:
     • Client ID
     • Client Secret
   • Under Application Scopes, enable the following permissions:
     • Read all files and folders stored in Box
     • Write all files and folders stored in Box

       The write permission is required by Box's API to download file content. RAGaaS only reads your files and never modifies any content.

   • Under CORS Domains, add allowed origin: https://api.ragaas.dev

2. Configure RAGaaS

Add your Box 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 '{
    "boxConfig": {
      "clientId": "your-box-client-id",
      "clientSecret": "your-box-client-secret"
    }
  }'

3. Create Box Connection

Now create a connection to your Box:

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

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

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

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

4. Ingest Box Content

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

# Start ingestion
curl -X POST https://api.ragaas.dev/v1/ingest/box \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "namespaceId": "ns_123",
    "ingestConfig": {
      "source": "BOX",
      "config": {
        "connectionId": "your-connection-id",
        "metadata": {
          "source": "box",
          "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 Box files: (docs)

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": "box"
      }
    }
  }'

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

• Learn about namespaces
• Explore search capabilities
• View the API reference