Upload Files to Analysis

Upload one or more files to an existing analysis for automatic processing by the Kruncher.ai analysis engine. Supports common document formats including PDF, DOCX, PPTX, and more.

Endpoint

POST https://api.kruncher.ai/api/integrationfiles/upload

Headers

Header	Required	Description
`Authorization`	Yes	Your API key (format: `YOUR_API_KEY`)
`analysisid`	Yes	The analysis ID returned when creating the project

Supported File Formats

PDF (.pdf) - Pitch decks, reports, financial statements
Word (.docx, .doc) - Business plans, memos
PowerPoint (.pptx, .ppt) - Presentations, decks
Excel (.xlsx, .xls) - Financial models, data sheets
Text (.txt, .md) - Plain text documents

Request Format

Files must be sent as multipart/form-data with the field name files. You can upload multiple files in a single request by repeating the files field.

Code Examples

Python

Single File

CODE

import requests
 
API_KEY = "YOUR_API_KEY_HERE"
ANALYSIS_ID = "analysis_123"
 
url = "https://api.kruncher.ai/api/integrationfiles/upload"
 
headers = {
    "Authorization": f"{API_KEY}",
    "analysisid": ANALYSIS_ID
}
 
# Upload a single file
with open("pitch-deck.pdf", "rb") as file:
    files = [("files", ("pitch-deck.pdf", file))]
    response = requests.post(url, headers=headers, files=files)
 
print(f"Status: {response.status_code}")
print(f"Response: {response.text}")

Result: Single file uploaded and queued for analysis.

Multiple Files

CODE

import requests
 
API_KEY = "YOUR_API_KEY_HERE"
ANALYSIS_ID = "analysis_123"
 
url = "https://api.kruncher.ai/api/integrationfiles/upload"
 
headers = {
    "Authorization": f"{API_KEY}",
    "analysisid": ANALYSIS_ID
}
 
# Upload multiple files at once
files = [
    ("files", ("pitch-deck.pdf", open("pitch-deck.pdf", "rb"))),
    ("files", ("financials.xlsx", open("financials.xlsx", "rb"))),
    ("files", ("business-plan.docx", open("business-plan.docx", "rb")))
]
 
response = requests.post(url, headers=headers, files=files)
 
# Close all file handles
for _, (_, file_obj) in files:
    file_obj.close()
 
print(f"Status: {response.status_code}")
print(f"Response: {response.json()}")

Result: Multiple files uploaded in a single request.

With Error Handling

CODE

import requests
from typing import List, Dict
from pathlib import Path
 
API_KEY = "YOUR_API_KEY_HERE"
BASE_URL = "https://api.kruncher.ai/api"
 
def upload_files_to_analysis(
    analysis_id: str,
    file_paths: List[str],
    api_key: str = API_KEY
) -> Dict:
    """
    Upload files to an existing analysis.
    
    Args:
        analysis_id: The ID of the analysis to upload to
        file_paths: List of file paths to upload
        api_key: Your Kruncher API key
    
    Returns:
        Dict containing upload response
        
    Raises:
        FileNotFoundError: If a file doesn't exist
        requests.HTTPError: If the upload fails
    """
    url = f"{BASE_URL}/integrationfiles/upload"
    
    headers = {
        "Authorization": f"{api_key}",
        "analysisid": analysis_id
    }
    
    # Validate files exist
    for file_path in file_paths:
        if not Path(file_path).exists():
            raise FileNotFoundError(f"File not found: {file_path}")
    
    # Open all files
    files_list = []
    file_handles = []
    
    try:
        for file_path in file_paths:
            file_handle = open(file_path, "rb")
            file_handles.append(file_handle)
            filename = Path(file_path).name
            files_list.append(("files", (filename, file_handle)))
        
        # Upload
        response = requests.post(url, headers=headers, files=files_list)
        response.raise_for_status()
        
        return response.json()
        
    except requests.exceptions.HTTPError as e:
        print(f"Upload failed: {response.status_code}")
        print(f"Error: {response.text}")
        raise
    except Exception as e:
        print(f"Error uploading files: {str(e)}")
        raise
    finally:
        # Always close file handles
        for file_handle in file_handles:
            file_handle.close()
 
# Usage example
try:
    result = upload_files_to_analysis(
        analysis_id="analysis_123",
        file_paths=[
            "pitch-deck.pdf",
            "financials.xlsx",
            "team-bios.docx"
        ]
    )
    print(f"Upload successful: {result}")
except Exception as e:
    print(f"Upload failed: {e}")

Result: Production-ready function with proper error handling and resource cleanup.

JavaScript/Node.js

Single File

CODE

const fs = require('fs');
const FormData = require('form-data');
const fetch = require('node-fetch');
 
const API_KEY = "YOUR_API_KEY_HERE";
const ANALYSIS_ID = "analysis_123";
 
const form = new FormData();
form.append('files', fs.createReadStream('pitch-deck.pdf'));
 
const response = await fetch('https://api.kruncher.ai/api/integrationfiles/upload', {
  method: 'POST',
  headers: {
    'Authorization': `${API_KEY}`,
    'analysisid': ANALYSIS_ID,
    ...form.getHeaders()
  },
  body: form
});
 
const result = await response.json();
console.log('Upload result:', result);

Result: Single file uploaded using FormData.

Multiple Files

CODE

const fs = require('fs');
const FormData = require('form-data');
const fetch = require('node-fetch');
 
const API_KEY = "YOUR_API_KEY_HERE";
const ANALYSIS_ID = "analysis_123";
 
const form = new FormData();
form.append('files', fs.createReadStream('pitch-deck.pdf'));
form.append('files', fs.createReadStream('financials.xlsx'));
form.append('files', fs.createReadStream('business-plan.docx'));
 
const response = await fetch('https://api.kruncher.ai/api/integrationfiles/upload', {
  method: 'POST',
  headers: {
    'Authorization': `${API_KEY}`,
    'analysisid': ANALYSIS_ID,
    ...form.getHeaders()
  },
  body: form
});
 
if (!response.ok) {
  throw new Error(`Upload failed: ${response.status} ${response.statusText}`);
}
 
const result = await response.json();
console.log('Files uploaded:', result);

Result: Multiple files uploaded in one request.

With FormData

CODE

const fs = require('fs');
const FormData = require('form-data');
const fetch = require('node-fetch');
 
const API_KEY = "YOUR_API_KEY_HERE";
const BASE_URL = "https://api.kruncher.ai/api";
 
/**
 * Upload files to an existing analysis
 * @param {string} analysisId - The analysis ID
 * @param {string[]} filePaths - Array of file paths to upload
 * @returns {Promise<Object>} Upload result
 */
async function uploadFilesToAnalysis(analysisId, filePaths) {
  // Validate files exist
  for (const filePath of filePaths) {
    if (!fs.existsSync(filePath)) {
      throw new Error(`File not found: ${filePath}`);
    }
  }
 
  const form = new FormData();
  
  // Add all files to form
  filePaths.forEach(filePath => {
    form.append('files', fs.createReadStream(filePath));
  });
 
  try {
    const response = await fetch(`${BASE_URL}/integrationfiles/upload`, {
      method: 'POST',
      headers: {
        'Authorization': `${API_KEY}`,
        'analysisid': analysisId,
        ...form.getHeaders()
      },
      body: form
    });
 
    if (!response.ok) {
      const errorText = await response.text();
      throw new Error(`Upload failed (${response.status}): ${errorText}`);
    }
 
    return await response.json();
  } catch (error) {
    console.error('Upload error:', error.message);
    throw error;
  }
}
 
// Usage
(async () => {
  try {
    const result = await uploadFilesToAnalysis('analysis_123', [
      'pitch-deck.pdf',
      'financials.xlsx',
      'team-bios.docx'
    ]);
    console.log('Upload successful:', result);
  } catch (error) {
    console.error('Failed to upload files:', error);
  }
})();

Result: Reusable function with validation and error handling.

cURL

Single File

CODE

curl -X POST "https://api.kruncher.ai/api/integrationfiles/upload" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  -H "analysisid: analysis_123" \
  -F "files=@pitch-deck.pdf"

Response

Success Response (200 OK)

CODE

{
  "code": "1000",
  "title": "Success",
  "description": "Files uploaded successfully",
  "data": {
    "filesUploaded": 3,
    "analysisId": "analysis_123",
    "status": "processing"
  }
}

Error Response (400 Bad Request)

CODE

{
  "code": "4000",
  "title": "Bad Request",
  "description": "Invalid analysis ID or missing files"
}

Important Notes

Request Format

Method: Must use POST (not PUT or other methods)
Content-Type: Automatically set to multipart/form-data by your HTTP client
Field Name: Use files for all file uploads (can be repeated)

File Handling

Multiple files can be uploaded in a single request
Each file is added with the same field name: files
Processing starts automatically after upload
Files are processed asynchronously

Best Practices

Close file handles after upload (especially in Python)
Validate file paths before uploading
Handle errors gracefully
Check file size limits (contact support for large files)

Typical Workflow

Create a company using the Create Company endpoint
Get the analysis ID from the creation response
Upload files using this endpoint with the analysisId
Wait for processing to complete (typically 1-5 minutes)
Retrieve results using the Analysis endpoints

Example: Complete Flow

CODE

import requests
 
API_KEY = "YOUR_API_KEY_HERE"
BASE_URL = "https://api.kruncher.ai/api"
 
# Step 1: Create company
create_response = requests.post(
    f"{BASE_URL}/integration/project",
    headers={
        "Authorization": f"{API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "name": "TechStartup",
        "companyName": "TechStartup Inc.",
        "companyWebsite": "https://techstartup.com",
        "projectType": "projectAnalysisWithFile"
    }
)
analysis_id = create_response.json()['analysisId']
 
# Step 2: Upload files
with open("pitch-deck.pdf", "rb") as file:
    files = [("files", ("pitch-deck.pdf", file))]
    upload_response = requests.post(
        f"{BASE_URL}/integrationfiles/upload",
        headers={
            "Authorization": f"{API_KEY}",
            "analysisid": analysis_id
        },
        files=files
    )
 
print(f"Upload status: {upload_response.status_code}")
 
# Step 3: Check analysis status
# (Processing happens automatically in the background)

Create Company - Create a company and get an analysis ID
Retrieve Companies - Get company and analysis data
Analysis - Access analysis results and insights

Need Help?

Large files? Contact support for enterprise upload limits
Unsupported format? Let us know what formats you need
Upload failing? Check your analysis ID and file permissions

Upload Files to Analysis

Endpoint

Headers

Supported File Formats

Request Format

Code Examples

Python

Single File

Multiple Files

With Error Handling

JavaScript/Node.js

Single File

Multiple Files

With FormData

cURL

Single File

Multiple Files

Response

Success Response (200 OK)

Error Response (400 Bad Request)

Important Notes

Request Format

File Handling

Best Practices

Typical Workflow

Example: Complete Flow

Related Endpoints

Need Help?