API Reference
hm_upload_file & hm_list_files
Upload files to S3 with AI summarization, and query uploaded files
hm_upload_file
Upload a file to S3 storage with automatic AI summarization. A graph node is created containing the generated summary.
File upload is available on Pro, Business, and Enterprise plans only.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
filename | str | required | Name of the file |
content_base64 | str | required | Base64-encoded file content |
Processing
| File type | Processing |
|---|---|
| Text files | Direct decode + LLM summary |
| Binary / office / images | LlamaParse extraction + LLM summary |
Files are stored in S3 (Scaleway). A graph node is created with the AI-generated summary as its description.
Storage limits
| Plan | Storage |
|---|---|
| Pro | 1 GB |
| Business | 100 GB |
| Enterprise | 1 TB |
Example
{
"filename": "architecture-notes.md",
"content_base64": "IyBBcmNoaXRlY3R1cmUgTm90ZXMKCi4uLg=="
}
hm_list_files
Query uploaded files by type or name.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
file_type | str | None | None | Filter by category (document, image, audio, video) |
search | str | None | None | Substring match on original filename |
limit | int | 50 | Max rows (1–200) |
Response
Returns a list of uploaded files with their metadata (name, type, size, upload date, associated node key).
Example
{
"file_type": "document",
"search": "architecture",
"limit": 25
}