{"openapi":"3.1.0","info":{"title":"Portable Memory","description":"Long-term memory that belongs to the user and follows them across machines and AI tools. Read it before saying you don't know something about them; write to it when you learn something durable.","version":"1.0.0"},"servers":[{"url":"https://memory.godspeedventures.dev"}],"paths":{"/identity":{"get":{"operationId":"listMemories","summary":"List every memory file","description":"Returns every file with its content and last-updated date. Call this to find out what is already known about the user before asking them to repeat themselves.","responses":{"200":{"description":"The user's memory files","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/memory/{filename}":{"get":{"operationId":"recallMemory","summary":"Read one memory file","description":"Read a single file. 'context.md' is a briefing on who the user is and how they want to be worked with.","parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string"},"description":"e.g. context.md"}],"responses":{"200":{"description":"The file contents","content":{"application/json":{"schema":{"type":"object"}}}}}},"delete":{"operationId":"forgetMemory","summary":"Delete one memory file","description":"Only use when the user explicitly asks to forget something.","parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/memory":{"post":{"operationId":"rememberMemory","summary":"Save or update a memory file","description":"Save something durable: how a project stands, a decision and why, a preference. Writing to an existing filename REPLACES it, so read it first and write back the merged version when updating.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"A memory file","properties":{"filename":{"type":"string","description":"Short kebab-case name ending in .md, e.g. project-dola-status.md"},"content":{"type":"string","description":"Full markdown content. Replaces the file."}},"required":["filename","content"]}}}},"responses":{"200":{"description":"Saved","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}