API Reference

Complete reference for all ExoGraph API endpoints.

Base URL: https://exograph.ai

Integration Methods

REST API (this page)

Use HTTP requests for programmatic access. Best for production applications.

MCP (Model Context Protocol) ⭐ NEW

Use ExoGraph from Claude Desktop and other AI tools with natural language.
Setup in 30 seconds →

---

Authentication

All endpoints require authentication via API key:

Authorization: Bearer exo_key_live_...

Endpoints Overview

Documents API

Endpoint	Method	Description
/api/documents	POST	Upload a document
/api/documents	GET	List all documents
/api/documents/{id}	GET	Get document details
/api/documents/{id}	DELETE	Delete a document

View Documents API →

---

Agent API (Core Features)

Endpoint	Method	Description
/agent/interactions	POST	Chat with AI reasoning
/agent/research	POST	Start research job
/agent/models	GET	List available models

View Agent API →

---

Knowledge Graphs API

Endpoint	Method	Description
/api/graphs	POST	Create a graph
/api/graphs	GET	List all graphs
/api/graphs/{id}	GET	Get graph data
/api/graphs/{id}/import-from-document	POST	Import document to graph

View Graphs API →

---

Search API

Endpoint	Method	Description
/api/search	GET	Search document content
/api/search/entities	GET	Search entities in graphs

View Search API →

---

Billing API

Endpoint	Method	Description
/api/billing/tokens	GET	Check token balance

View Billing API →

---

Utility Endpoints

Endpoint	Method	Description
/health	GET	API health check

---

Rate Limits

All API keys are subject to rate limits:

Window	Limit
Per minute	60 requests
Per day	10,000 requests

Headers in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1697712000
X-RateLimit-Limit-Day: 10000
X-RateLimit-Remaining-Day: 9823

---

Token Pricing

Purchase

• $1 = 4 tokens
• Available in web app: Settings → Billing

Costs Per Operation

Operation	Snap	Ponder
Chat query	3 tokens	10 tokens
Research job	30 tokens	100 tokens
Document upload	5 + 1/page	5 + 1/page
Search/Graphs	Free	Free

Models:

• Snap: Fast responses (gpt-3.5-turbo)
• Ponder: Deep thinking (gpt-4o, gpt-4o-mini, o1-mini)

---

Error Codes

Code	Description
401	Invalid or expired API key
402	Insufficient tokens
429	Rate limit exceeded
400	Bad request (invalid parameters)
404	Resource not found
500	Internal server error

Error Response Format:

{
  "error": {
    "code": "insufficient_tokens",
    "message": "Insufficient tokens. Need 10, have 3.",
    "details": {
      "required": 10,
      "available": 3
    }
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2025-10-19T12:00:00Z"
  }
}

---

Detailed Endpoint Documentation

• Documents API - Upload and manage documents
• Agent API - Chat and research with AI
• Research API - Autonomous research
• Knowledge Graphs API - Build and query graphs
• Search API - Semantic search
• Billing API - Manage tokens

---

Questions? Contact support@exograph.ai