Upload a raw document to a given assistant

x-api-key: your_api_key_here

curl --request POST \
  'https://api.vambe.me/api/documents/assistant/raw' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key_here' \
  --data-raw '{
    "content": "# Product FAQ\n\nQ: How to reset password?\nA: Go to settings...",
    "fileName": "product-faq.md",
    "externalId": "ext-product-faq-001",
    "folderId": "550e8400-e29b-41d4-a716-446655440000",
    "assistantId": "660e8400-e29b-41d4-a716-446655440001",
    "icon": "❓"
  }'

{
  "ragieDocument": {
    "id": "ragie-doc-12345",
    "name": "product-faq.md",
    "status": "initialized",
    "chunk_count": 0,
    "external_id": "ext-product-faq-001",
    "created_at": "2024-09-30T10:00:00.000Z",
    "updated_at": "2024-09-30T10:00:00.000Z",
    "metadata": {
      "clientId": "660e8400-e29b-41d4-a716-446655440001",
      "folderId": "550e8400-e29b-41d4-a716-446655440000",
      "source_type": "vambe"
    }
  },
  "savedDocument": {
    "id": "ragie-doc-12345",
    "name": "product-faq.md",
    "icon": "❓",
    "parent_folder_id": "550e8400-e29b-41d4-a716-446655440000",
    "content": "# Product FAQ\n\nQ: How to reset password?\nA: Go to settings...",
    "client_id": "660e8400-e29b-41d4-a716-446655440001",
    "src_type": "vambe",
    "is_public": false,
    "created_at": "2024-09-30T10:00:00.000Z",
    "updated_at": "2024-09-30T10:00:00.000Z"
  }
}

const uploadFAQ = async (folderId) => {
  const faqContent = `
# Frequently Asked Questions

## Billing
Q: How do I update my payment method?
A: Go to Settings > Billing > Payment Methods

Q: What payment methods do you accept?
A: We accept credit cards, PayPal, and wire transfer

## Account
Q: How do I reset my password?
A: Click "Forgot Password" on the login page
  `.trim();

  const response = await fetch(
    'https://api.vambe.me/api/documents/assistant/raw',
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': 'your_api_key_here',
      },
      body: JSON.stringify({
        content: faqContent,
        fileName: 'billing-faq.md',
        externalId: `faq-${Date.now()}`,
        folderId: folderId,
        icon: '❓',
      }),
    },
  );

  const result = await response.json();
  console.log('FAQ uploaded:', result.savedDocument.name);

  return result;
};

const bulkUploadDocuments = async (folderId, documents) => {
  const results = [];

  for (const doc of documents) {
    try {
      const response = await fetch(
        'https://api.vambe.me/api/documents/assistant/raw',
        {
          method: 'POST',
          headers: {
            'Content-Type': 'application/json',
            'x-api-key': 'your_api_key_here',
          },
          body: JSON.stringify({
            content: doc.content,
            fileName: doc.fileName,
            externalId: doc.id,
            folderId: folderId,
            icon: doc.icon || '📄',
          }),
        },
      );

      const result = await response.json();
      results.push({
        success: true,
        fileName: doc.fileName,
        id: result.savedDocument.id,
      });

      console.log(`✅ Uploaded: ${doc.fileName}`);
    } catch (error) {
      results.push({
        success: false,
        fileName: doc.fileName,
        error: error.message,
      });
      console.error(`❌ Failed: ${doc.fileName}`);
    }

    // Small delay to avoid rate limiting
    await new Promise((resolve) => setTimeout(resolve, 200));
  }

  console.log(
    `Uploaded ${results.filter((r) => r.success).length} of ${documents.length} documents`,
  );

  return results;
};

const uploadAndLinkToAssistant = async (assistantId, folderId, docData) => {
  const response = await fetch(
    'https://api.vambe.me/api/documents/assistant/raw',
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': 'your_api_key_here',
      },
      body: JSON.stringify({
        content: docData.content,
        fileName: docData.fileName,
        externalId: docData.externalId,
        folderId: folderId,
        assistantId: assistantId, // Links folder to assistant
        icon: '🤖',
      }),
    },
  );

  const result = await response.json();

  console.log('Document uploaded and linked to assistant');
  console.log('Ragie ID:', result.ragieDocument.id);
  console.log('DB ID:', result.savedDocument.id);

  return result;
};

const syncFromCMS = async (cmsArticles, folderId) => {
  const syncResults = [];

  for (const article of cmsArticles) {
    const response = await fetch(
      'https://api.vambe.me/api/documents/assistant/raw',
      {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'x-api-key': 'your_api_key_here',
        },
        body: JSON.stringify({
          content: article.content,
          fileName: article.title,
          externalId: `cms-${article.id}`, // Use CMS ID as external ID
          folderId: folderId,
          icon: article.category === 'guide' ? '📖' : '📄',
        }),
      },
    );

    const result = await response.json();
    syncResults.push({
      cmsId: article.id,
      ragieId: result.ragieDocument.id,
      title: article.title,
    });
  }

  console.log(`Synced ${syncResults.length} articles from CMS`);

  return syncResults;
};

Product X is our flagship solution...

# Product X Overview

## Features

- Feature 1
- Feature 2

## Pricing

Starting at $99/month

<h1>Product Guide</h1>
<p>This is our product...</p>

// Good: Clear, trackable IDs
externalId: 'product-guide-v2';
externalId: 'faq-billing-2024-09';
externalId: `cms-${article.id}`;

// Avoid: Generic or unclear IDs
externalId: 'doc1';
externalId: 'temp';

const iconsByType = {
  faq: '❓',
  guide: '📖',
  policy: '📋',
  api: '🔌',
  tutorial: '🎓',
};

const icon = iconsByType[documentType] || '📄';

try {
  const result = await uploadDocument(data);
  console.log('✅ Upload successful');
} catch (error) {
  if (error.status === 404) {
    console.error('Folder not found - create it first');
  } else if (error.status === 400) {
    console.error('Invalid data:', error.message);
  } else {
    console.error('Upload failed:', error);
  }
}