API Reference

All API requests use https://fathippo.ai/api/v1 as the base URL and require authentication via Bearer token.

Authentication

Include your API key in the Authorization header:

Authorization: Bearer mem_your_api_key

Header	Required	Description
`Authorization`	Yes	Bearer token with your API key
`Content-Type`	Yes (POST)	application/json for POST requests

Endpoint Overview

Core Memory Operations

POST/v1/memoriesStore a memory

GET/v1/memoriesList memories

GET/v1/memories/{id}Get single memory

DELETE/v1/memories/{id}Delete memory

POST/v1/searchSemantic search

Context & Sessions

POST/v1/contextGet session context

POST/v1/context/refreshRefresh mid-conversation

POST/v1/sessions/startStart session

POST/v1/sessions/{id}/turnRecord turn

POST/v1/sessions/{id}/endEnd session

Intelligence

POST/v1/memories/{id}/reinforceFeedback

POST/v1/memories/{id}/lockLock tier

POST/v1/memories/missLog miss

GET/v1/memories/missesGet misses

POST/v1/extractExtract from conversation

POST/v1/explainDebug retrieval

Simple API

POST/v1/simple/rememberStore (auto-everything)

POST/v1/simple/recallSearch (text only)

POST/v1/simple/contextGet injectable string

Cognitive (Coding)

POST/v1/cognitive/tracesRecord coding trace

POST/v1/cognitive/traces/relevantGet cognitive context

GET/v1/cognitive/skills/{id}Get skill detail

POST/v1/cognitive/skillsCreate skill

POST/v1/cognitive/patterns/feedbackSubmit pattern feedback

MCP Server

The FatHippo MCP server wraps all session, memory, and cognitive endpoints into 12 tools for use with Codex, Claude Desktop, Cursor, and OpenClaw. See the MCP Tools Reference for full documentation.

Analytics

POST/v1/analyticsFull analytics

GET/v1/analytics/summaryQuick stats

Error Handling

All errors return a consistent JSON format:

{
  "error": "VALIDATION_ERROR",
  "message": "Field 'query' is required",
  "details": { "field": "query", "reason": "required" }
}

Error Code	HTTP Status	Description
`UNAUTHORIZED`	401	Missing or invalid API key
`FORBIDDEN`	403	API key doesn't have required scope
`NOT_FOUND`	404	Resource not found
`VALIDATION_ERROR`	400	Invalid request body or parameters
`MEMORY_NOT_FOUND`	404	Memory ID doesn't exist
`SESSION_NOT_FOUND`	404	Session ID doesn't exist
`RATE_LIMITED`	429	Too many requests
`INTERNAL_ERROR`	500	Server error

Pagination

List endpoints support pagination via limit and since parameters:

GET /v1/memories?limit=50&since=2026-03-01T00:00:00Z

Rate Limits

Plan	Requests/min	Memories	Searches/mo
`Free`	60	1,000	10,000
`Pro`	300	Unlimited	Unlimited
`Enterprise`	Custom	Custom	Custom

Note

Rate limit headers are included in every response:X-RateLimit-Remaining and X-RateLimit-Reset.