Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.engramme.com/llms.txt

Use this file to discover all available pages before exploring further.

File endpoints let you inspect and manage uploaded source files. They require an API key with access to the relevant source type.
These examples require an all-source key or a key that includes the requested SOURCE_TYPE.

​
Endpoints

MethodEndpointDescription
GET/v1/files/listList files for a source_type
GET/v1/files/downloadDownload a file by item_id
DELETE/v1/files/{source_type}/{item_id}Delete a file

​
List Files

Query parameters:
ParameterRequiredDescription
source_typeYesSource type to list, such as text or email
limitNoPage size. Defaults to 1000; max 10000
offsetNoPagination offset
start_dateNoAccepted by the API, but date filtering is not currently applied
export SOURCE_TYPE="text"

curl "https://memorymachines-gateway-prod-btf57kda.uc.gateway.dev/v1/files/list?source_type=$SOURCE_TYPE" \
  -H "x-api-key: $ENGRAMME_API_KEY"

​
Download a File

source_type is optional for download. Include it when you know the source; omitting it asks the API to search sources available to the key. 
export SOURCE_TYPE="text"
export ITEM_ID="YOUR_ITEM_ID"

curl "https://memorymachines-gateway-prod-btf57kda.uc.gateway.dev/v1/files/download?item_id=$ITEM_ID&source_type=$SOURCE_TYPE" \
  -H "x-api-key: $ENGRAMME_API_KEY"

​
Delete a File

export SOURCE_TYPE="text"
export ITEM_ID="YOUR_ITEM_ID"

curl -X DELETE "https://memorymachines-gateway-prod-btf57kda.uc.gateway.dev/v1/files/$SOURCE_TYPE/$ITEM_ID" \
  -H "x-api-key: $ENGRAMME_API_KEY"
Deletes are destructive. Use source-scoped keys carefully when building file management tools.