Files

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

Method	Endpoint	Description
`GET`	`/v1/files/list`	List files for a `source_type`
`GET`	`/v1/files/download`	Download a file by `item_id`
`DELETE`	`/v1/files/{source_type}/{item_id}`	Delete a file

List Files

Query parameters:

Parameter	Required	Description
`source_type`	Yes	Source type to list, such as `text` or `email`
`limit`	No	Page size. Defaults to `1000`; max `10000`
`offset`	No	Pagination offset
`start_date`	No	Accepted 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.

Get Started

Console Setup

API Reference

SDKs

Endpoints

List Files

Download a File

Delete a File

​Endpoints

​List Files

​Download a File

​Delete a File

Endpoints

List Files

Download a File

Delete a File