AlwaysForever.ai / API Reference

Documentation

Base URL: https://dev.alwaysforever.ai

Getting Started

Install CLI, store & recall your first memory in 5 minutes

CLI Reference

Every command, flag, and integration example

Authentication

All API endpoints require an API key passed via the Authorization header.

Authorization: Bearer af_live_YOUR_API_KEY

v1 API (Primary)

POST /v1/memory/store Store a memory (STM, conversation, or event)
POST /v1/memory/recall Semantic search across all memories
GET /v1/memory/recent Get recent memories
GET /v1/sessions List sessions
GET /v1/sessions/{id} Get session details
POST /v1/memory/export Export all memories
POST /v1/memory/delete Delete memories

Platform

GET /health Platform health status
GET /api/health/* Uriel health monitoring

Memory (Raguel)

GET /api/memory/* Query memory store
GET /api/session/* Session discovery & recovery
GET /api/sessions/* Session listing
GET /api/ssm/* Session summary memory
GET /api/files/* File index search

Enrichment

POST /api/raguel/enrich/* Enrich content (tags, embeddings, cathexis)
POST /api/raguel/embed Generate embeddings
GET /api/raguel/stats Enrichment statistics

Identity (Soul)

POST /api/soul/agents/create Create a new agent
POST /api/soul/projects/create Create a new project
GET /api/soul/accounts/{uid} Get account info

Ingestion (Gabriel)

POST /api/ingest/* Ingest messages via Gabriel router

Public (No auth required)

POST /api/soul/beta/signup Beta signup with invite code Public