{"openapi":"3.1.0","info":{"title":"CogniMemo API","version":"1.0.0","description":"Persistent memory API for AI agents — retain, recall, and reflect.","contact":{"name":"CogniMemo","url":"https://cognimemo.com","email":"support@cognimemo.com"}},"servers":[{"url":"https://api.cognimemo.com","description":"CogniMemo Gateway API"}],"paths":{"/v1/retain":{"post":{"summary":"Store a memory","operationId":"retain","security":[{"oauth2":["memory:retain"]},{"apiKey":[]}],"responses":{"200":{"description":"Memory retained"}}}},"/v1/recall":{"post":{"summary":"Retrieve memories","operationId":"recall","security":[{"oauth2":["memory:recall"]},{"apiKey":[]}],"responses":{"200":{"description":"Memories recalled"}}}},"/v1/reflect":{"post":{"summary":"Synthesize an answer from memories","operationId":"reflect","security":[{"oauth2":["memory:reflect"]},{"apiKey":[]}],"responses":{"200":{"description":"Reflection generated"}}}}},"components":{"securitySchemes":{"oauth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://cognimemo.com/oauth/authorize","tokenUrl":"https://api.cognimemo.com/oauth/token","scopes":{"memory:retain":"Store memories via retain operations","memory:recall":"Read memories via recall and list operations","memory:reflect":"Generate synthesized answers via reflect","memory:delete":"Delete or forget memories","mcp":"Connect to the CogniMemo MCP server","project:read":"Read project metadata, usage, and configuration","project:write":"Manage API keys, banks, and project settings"}},"clientCredentials":{"tokenUrl":"https://api.cognimemo.com/oauth/token","scopes":{"memory:retain":"Store memories via retain operations","memory:recall":"Read memories via recall and list operations","memory:reflect":"Generate synthesized answers via reflect","memory:delete":"Delete or forget memories","mcp":"Connect to the CogniMemo MCP server","project:read":"Read project metadata, usage, and configuration","project:write":"Manage API keys, banks, and project settings"}}}},"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Project API key prefixed with cmk_live_"}}},"security":[{"oauth2":["memory:retain","memory:recall","memory:reflect","memory:delete","mcp","project:read","project:write"]}],"externalDocs":{"description":"CogniMemo developer resources","url":"https://cognimemo.com/developers"},"x-cognimemo-resources":[{"name":"CogniMemo API Reference","href":"https://docs.cognimemo.com/api","description":"REST API for retain, recall, and reflect operations"},{"name":"CogniMemo OpenAPI Specification","href":"https://cognimemo.com/openapi.json","description":"Machine-readable OpenAPI 3.1 spec with OAuth scopes"},{"name":"CogniMemo MCP Server","href":"https://cognimemo.com/mcp","description":"Model Context Protocol server for Claude, Cursor, and Windsurf"},{"name":"CogniMemo TypeScript SDK","href":"https://docs.cognimemo.com/sdks/typescript","description":"Official @cognimemo/client package"},{"name":"CogniMemo Python SDK","href":"https://docs.cognimemo.com/sdks/python","description":"Official cognimemo-client package"},{"name":"CogniMemo Playground","href":"https://docs.cognimemo.com/playground","description":"Live sandbox for testing retain, recall, and reflect"},{"name":"CogniMemo Self-Hosting Guide","href":"https://docs.cognimemo.com/self-hosting/overview","description":"Run the memory engine on your own infrastructure"},{"name":"CogniMemo GitHub","href":"https://github.com/ProjectMorrow/cognimemo-docs","description":"Documentation and examples repository"}],"x-cognimemo-onboarding":{"freeTier":{"available":true,"signupUrl":"https://app.cognimemo.com/signup","description":"Free tier includes 1,000 memories, 5,000 recalls, and 100 reflects per month."},"apiKeys":{"selfServe":true,"url":"https://app.cognimemo.com/connect/api-keys","description":"Create scoped API keys (cmk_live_…) instantly in the CogniMemo console."},"sandbox":{"available":true,"playgroundUrl":"https://docs.cognimemo.com/playground","description":"Test retain, recall, and reflect in the live playground without writing code."}}}