Summary
Write a formal OpenAPI 3.0 specification for all Memtrace REST API endpoints. This unlocks auto-generated SDK clients, Postman collections, and ChatGPT GPT Actions.
Scope
Cover all endpoints documented in docs/api.md:
- Health:
GET /health, GET /ready
- Memories:
POST /api/v1/memories, GET /api/v1/memories, GET /api/v1/memories/:id
- Agents: Full CRUD + stats
- Sessions: Full lifecycle +
POST /api/v1/sessions/:id/context
- Search:
POST /api/v1/search
Include authentication schema (x-api-key header with mtk_ prefix).
Downstream
- Enables ChatGPT GPT Action (#issue)
- Enables auto-generated clients for any language
- Enables Postman/Insomnia collections
Summary
Write a formal OpenAPI 3.0 specification for all Memtrace REST API endpoints. This unlocks auto-generated SDK clients, Postman collections, and ChatGPT GPT Actions.
Scope
Cover all endpoints documented in
docs/api.md:GET /health,GET /readyPOST /api/v1/memories,GET /api/v1/memories,GET /api/v1/memories/:idPOST /api/v1/sessions/:id/contextPOST /api/v1/searchInclude authentication schema (
x-api-keyheader withmtk_prefix).Downstream