Skip to Content
DocumentationAPI ReferenceOverview

API Reference

The Cortex API is a RESTful JSON API built with FastAPI. All authenticated endpoints require a Bearer token.

Base URL

Production: https://api.cortex-app.dev Local: http://localhost:8000

Authentication

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \ https://api.cortex-app.dev/api/...

Response Format

All responses return JSON. Successful responses return the data directly. Errors return:

{ "detail": "Error description" }

HTTP Status Codes

CodeMeaning
200Success
201Created
400Bad request — check your payload
401Unauthorized — invalid or missing token
403Forbidden — insufficient tier
404Not found
429Rate limited — quota exceeded
500Server error

Endpoints Overview

Public (No Auth)

MethodPathDescription
GET/healthHealth check
GET/api/pricingTier pricing info
GET/api/demo/graphDemo graph data
POST/api/demo/askDemo AI query

Notes

MethodPathDescription
POST/api/workspace/notesCreate a note
PUT/api/workspace/notes/:idUpdate a note
GET/api/graph/notesList/search notes
MethodPathDescription
POST/api/workspace/linksCreate a link

Recall

MethodPathDescription
POST/api/askAI-powered recall query

Graph

MethodPathDescription
GET/api/graph/statsGraph statistics

Activity

MethodPathDescription
GET/api/activity/streamSSE event stream

Quota

MethodPathDescription
GET/api/quotaUsage quota
Last updated on