Memory
Memory files
List the reference files behind a memory guide, read one as text, or download it.
AuthenticationRequires
memory:manage on a personal API key. A CLI session always passes.The memory guide is rendered from a set of files: the SKILL.md guide itself, extracted text references, and the original uploads they came from. These routes list and read those files. :ownerType is organization or membership.
List
GET
https://cloud.generalinput.com/v1/memory/:ownerType/files{
"files": [
{
"path": "SKILL.md",
"title": "Memory",
"description": "The rendered guide.",
"kind": "text",
"mimeType": "text/markdown",
"sizeBytes": null
},
{
"path": "originals/file_01HX…/handbook.pdf",
"title": "handbook.pdf",
"description": "Uploaded original.",
"kind": "original",
"mimeType": "application/pdf",
"sizeBytes": 184320
}
]
}kind is text for the guide and its extracted references, original for an uploaded file kept under originals/<fileId>/<filename>.
Read one file
GET
https://cloud.generalinput.com/v1/memory/:ownerType/files/text?path=Returns { "path": "…", "text": "…" }. A binary file answers 400; download it instead.
GET
https://cloud.generalinput.com/v1/memory/:ownerType/files/download?path=Streams the raw bytes with the file's content type.
Download everything
GET
https://cloud.generalinput.com/v1/memory/:ownerType/files/bundleEvery memory file as one gzipped tar.
Errors
| Status | When |
|---|---|
400 | Missing path, invalid ownerType, or reading a binary file as text. |
403 | The member may not read this owner's memory. |
404 | No file at path. |