Skip to Content
API ReferenceOverview

API Reference

Complete reference documentation for all Sophosic Platform API endpoints.

OpenAPI Specification

This reference is auto-generated from our OpenAPI specification. View the raw OpenAPI schema.

Base URL

https://api.sophosic.ai

Authentication

All API requests require an Authorization header with your API key:

Authorization: Bearer YOUR_API_KEY

See the Authentication Guide for details.

Endpoints by Category

Core APIs

  • Chat Completions: /api/chat/v5 - Real-time AI conversations
  • Suggestions: /api/suggestions - Smart response suggestions
  • Title Generation: /api/generate-title - Automatic titles

Agent System

  • Memory Operations: /api/user/memories - Agent memory management
  • Insights: /api/insights/discovery - Background analysis
  • Context: /api/context/unified/{userId} - Context injection

Knowledge Base

  • Articles: /api/knowledge/articles - Document CRUD
  • Categories: /api/knowledge/categories - Organization
  • Search: /api/search - Semantic search

SOPs (Workflows)

  • CRUD: /api/sops - SOP management
  • Triggers: /api/sops/{id}/trigger - Execution
  • Runs: /api/sops/{id}/runs - Status monitoring

MCP Integration

  • Hosted Servers: /api/mcp/hosted - MCP management
  • Statistics: /api/mcp/stats - Usage metrics

Response Format

All successful responses return JSON:

{
  "data": {},
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "version": "1.0"
  }
}

Error Responses

Errors follow a consistent format:

{
  "error": "ErrorCode",
  "message": "Human-readable message",
  "statusCode": 400,
  "details": {}
}

See Error Handling for details.

Rate Limiting

Responses include rate limit headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1640995200

See Rate Limits for details.

Next Steps

Last updated on
URL-Encoded MessagesDashboard
API Reference Introduction | Sophosic™ Platform