REST + OpenAI-compatible

API reference

MemoryFirst exposes two API surfaces: a native REST API and an OpenAI-compatible chat endpoint for drop-in replacement.

Base URL

https://api.memoryfirst.ai/v1

Authentication

All requests require an API key in the Authorization header:

curl https://api.memoryfirst.ai/v1/experts/{expertId}/query \
  -H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"question": "What did we promise this client?", "k": 8}'

Endpoints

  • POST /v1/experts/{id}/sources: ingest a new source
  • POST /v1/experts/{id}/query: query memory with citations
  • GET /v1/experts: list experts in your workspace
  • POST /v1/experts: create new expert
  • GET /v1/usage: current period usage stats
  • POST /v1/chat/completions: OpenAI-compatible (drop-in)

Full OpenAPI 3.1 spec coming soon. Email jose.diaz@memoryfirst.ai for access.