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

ParameterTypeDefaultDescription
filenamestrrequiredName of the file
content_base64strrequiredBase64-encoded file content

Processing

File typeProcessing
Text filesDirect decode + LLM summary
Binary / office / imagesLlamaParse extraction + LLM summary

Files are stored in S3 (Scaleway). A graph node is created with the AI-generated summary as its description.

Storage limits

PlanStorage
Pro1 GB
Business100 GB
Enterprise1 TB

Example

{
  "filename": "architecture-notes.md",
  "content_base64": "IyBBcmNoaXRlY3R1cmUgTm90ZXMKCi4uLg=="
}

hm_list_files

Query uploaded files by type or name.

Parameters

ParameterTypeDefaultDescription
file_typestr | NoneNoneFilter by category (document, image, audio, video)
searchstr | NoneNoneSubstring match on original filename
limitint50Max 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
}