Skip to main content

​
API Introduction

The Fabius API allows you to programmatically interact with your data and automate workflows. This enables you to build custom integrations, automate document uploads, and retrieve analysis results.

​
Getting Started

To use the Fabius API, you’ll need:
  1. API Credentials: Generate API keys from your account settings
  2. Base URL: Use the appropriate endpoint for your environment
  3. Authentication: Include your credentials in API requests

​
Available Endpoints

The API currently supports:
  • Document Management: Upload and retrieve documents
  • Analysis Results: Access AI-powered analysis data from your documents

​
Key Concepts

​
Document Analysis

When you upload documents to Fabius, they are automatically processed by AI analysis configurations. These analyses extract valuable insights and structured data from your content.

​
Analysis Components

Each analysis result contains:
  • Configuration: The specific analysis type that was run (e.g., “Sales Call Analysis”, “Customer Feedback Review”)
  • Fields: The data points extracted by the analysis

​
Field Types

Analysis fields come in two main types:
  1. Score Fields: Numerical evaluations with qualitative context
    • Numeric score (when applicable)
    • Pros: Positive aspects identified
    • Cons: Areas needing improvement
    • Suggestions: Actionable recommendations
  2. Value Fields: Extracted data in various formats
    • Single text values (e.g., “Next Steps: Schedule follow-up meeting”)
    • Multiple values (e.g., [“Pricing”, “Features”, “Timeline”])
    • Structured data (e.g., competitor mentions with context)

​
Accessing Analysis Results

When you retrieve a document through the API, you’ll receive:
  • Document metadata (name, timestamps, associations)
  • Complete analysis results with all extracted fields
  • Human-readable field names and configuration details
The list endpoint provides an analysisCount to help you identify which documents have been analyzed without retrieving full details.

​
Quick Example

Here’s a simple example of creating a document via the API: 
curl -X POST https://api.fabius.io/external/v1/documents \
  -u "your-client-id:your-client-secret" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q4 Sales Report",
    "content": "Document content here...",
    "userEmail": "[email protected]"
  }'

​
Next Steps

Authentication

Learn how to authenticate API requests

Document Management

Upload and manage documents via API

Error Handling

Understand API error responses