API Reference - Velixar

Base URL
Authentication
Endpoints
Common response format
Error format

Base URL

https://api.velixarai.com/v1

Authentication

All endpoints require a Bearer token:

Authorization: Bearer vlx_your_api_key

Endpoints

POST /v1/memory

Store a new memory

GET /v1/memory/search

Search memories by semantic similarity

GET /v1/memory/:id

Retrieve a specific memory

GET /v1/memory/list

List memories with pagination

PATCH /v1/memory/:id

Update a memory

DELETE /v1/memory/:id

Delete a memory

GET /v1/health

Common response format

All successful responses return JSON:

{
  "data": { ... },
  "status": "ok"
}

Error format

{
  "error": "error_code",
  "message": "Human-readable description",
  "status": 400
}

Code	Error	Description
400	`bad_request`	Invalid parameters
401	`unauthorized`	Missing or invalid API key
403	`forbidden`	Key lacks required scope
404	`not_found`	Memory not found
429	`rate_limit_exceeded`	Too many requests
500	`internal_error`	Server error

⌘I