Files
hm_list_files
List the files stored in your memory
hm_list_files lists files you have uploaded — through an agent, the CLI or the dashboard — with their processing status.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
file_type | string | — | Only one category: document, image, audio or video. |
search | string | — | Match against the original filename. |
limit | integer | 50 | Maximum files to return (1–200). |
Response
| Field | Description |
|---|---|
files | Each with file_id, filename, file_type, content_type, size_bytes, processing_status, processing_phase, processing_error, can_resume, node_key, summary and uploaded_at. |
count, total | Files returned, and files matching in total. |
Example
{ "file_type": "document", "search": "architecture", "limit": 25 }