Download Item

curl -L 'https://app.memorylake.ai/openapi/memorylake/api/v1/drives/items/sc-5c6bf0f82d624a20a6fa4696997bdd46:7d8cf1e93f634b31b5/binary' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -o report.pdf

import requests

BASE = "https://app.memorylake.ai/openapi/memorylake/api/v1"
HEADERS = {"Authorization": "Bearer sk_xxxxxx"}

def download_item(item_id: str, path: str) -> None:
    """Download a Library file to a local path."""
    resp = requests.get(
        f"{BASE}/drives/items/{item_id}/binary",
        headers=HEADERS,
        stream=True,  # follows the 303 and drops your API key on the way
    )
    resp.raise_for_status()
    with open(path, "wb") as f:
        for chunk in resp.iter_content(chunk_size=1024 * 1024):
            f.write(chunk)

HTTP/1.1 303 See Other
Location: https://<storage-host>/<path>?<signature>
Content-Length: 0

{
  "success": false,
  "message": "This resource does not support download",
  "error_code": "DOWNLOAD_NOT_SUPPORTED"
}

curl -L 'https://app.memorylake.ai/openapi/memorylake/api/v1/drives/items/sc-5c6bf0f82d624a20a6fa4696997bdd46:7d8cf1e93f634b31b5/binary' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -o report.pdf

import requests

BASE = "https://app.memorylake.ai/openapi/memorylake/api/v1"
HEADERS = {"Authorization": "Bearer sk_xxxxxx"}

def download_item(item_id: str, path: str) -> None:
    """Download a Library file to a local path."""
    resp = requests.get(
        f"{BASE}/drives/items/{item_id}/binary",
        headers=HEADERS,
        stream=True,  # follows the 303 and drops your API key on the way
    )
    resp.raise_for_status()
    with open(path, "wb") as f:
        for chunk in resp.iter_content(chunk_size=1024 * 1024):
            f.write(chunk)

HTTP/1.1 303 See Other
Location: https://<storage-host>/<path>?<signature>
Content-Length: 0

{
  "success": false,
  "message": "This resource does not support download",
  "error_code": "DOWNLOAD_NOT_SUPPORTED"
}

GET /openapi/memorylake/api/v1/drives/items/{item_id}/binary

Downloads the content of a Library file. Usually the response is a 303 redirect to a storage URL that serves the file. For files whose storage cannot be read through a plain URL, MemoryLake streams the content back itself with 200. Follow redirects and you get the file either way.

Permission required: drive:item_read · service

Path Parameters

string

required

ID of the file to download. Folders, including MY_SPACE, cannot be downloaded.

Following the redirect

The storage URL in the Location header carries its own signature:

Request it without your API key. Storage rejects a request that also carries an Authorization header. curl -L and Python requests drop the header for you when they follow the redirect. If your HTTP client forwards headers on redirect, turn automatic redirects off and request the Location URL yourself.
Use it right away. The URL expires after a short time. When you need the file again later, call this endpoint again instead of saving the URL.

The file downloads as an attachment named after the Library item.

curl -L 'https://app.memorylake.ai/openapi/memorylake/api/v1/drives/items/sc-5c6bf0f82d624a20a6fa4696997bdd46:7d8cf1e93f634b31b5/binary' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -o report.pdf

import requests

BASE = "https://app.memorylake.ai/openapi/memorylake/api/v1"
HEADERS = {"Authorization": "Bearer sk_xxxxxx"}

def download_item(item_id: str, path: str) -> None:
    """Download a Library file to a local path."""
    resp = requests.get(
        f"{BASE}/drives/items/{item_id}/binary",
        headers=HEADERS,
        stream=True,  # follows the 303 and drops your API key on the way
    )
    resp.raise_for_status()
    with open(path, "wb") as f:
        for chunk in resp.iter_content(chunk_size=1024 * 1024):
            f.write(chunk)

Response

Status	Body	When
`303`	Empty	Most files. The `Location` header holds the storage URL that serves the file
`200`	The file content	Files whose storage cannot be read through a plain URL. MemoryLake streams the content back itself

Errors

Status	Error code	When
`400`	`DOWNLOAD_NOT_SUPPORTED`	The item is a folder, or cannot be downloaded for another reason
`404`	—	No item with this `item_id` exists. This response has no body

HTTP/1.1 303 See Other
Location: https://<storage-host>/<path>?<signature>
Content-Length: 0

{
  "success": false,
  "message": "This resource does not support download",
  "error_code": "DOWNLOAD_NOT_SUPPORTED"
}

MemoryLake API

Memory Router API

Path Parameters

Following the redirect

Response

Errors

​Path Parameters

​Following the redirect

​Response

​Errors

Path Parameters

Following the redirect

Response

Errors