Skip to main content

​
Base URL

https://api.velixarai.com

​
Authentication

All endpoints require a Bearer token: 
Authorization: Bearer vlx_your_api_key
Get your key from Settings → API Keys.

​
Memory

POST /memory

Store a new memory

GET /memory/search

Semantic search across memories

GET /memory/:id

Retrieve a specific memory

GET /memory/list

List memories with pagination

PATCH /memory/:id

Update a memory

DELETE /memory/:id

Delete a memory

​
Knowledge Graph

GET /graph/entities

List knowledge graph entities

POST /graph/traverse

Walk entity relationships from a focal point

POST /graph/search

Search entities by name or type

​
Identity & Cognitive

GET /memory/identity

Get user identity profile

GET /exocortex/overview

Knowledge graph stats and memory density

GET /exocortex/contradictions

Detect conflicting memories

​
Integration

POST /webhook/ci

CI/CD event ingestion — store deployment, PR, and decision events as memories

GET /health

Health check

​
OpenAPI Spec

A full OpenAPI 3.1 specification is available for code generation and API exploration.

​
Response Format

All successful responses return JSON: 
{
  "id": "abc-123",
  "content": "...",
  "tags": ["decision", "architecture"]
}

​
Error Format

{
  "error": "Human-readable description",
  "status": 400
}
CodeMeaning
400Invalid parameters
401Missing or invalid API key
403Key lacks required scope
404Resource not found
429Rate limit exceeded (check Retry-After header)
500Server error