Download data

result = volume.files.download_file("/models/model.bin", "./model.bin")
print(result.path, result.bytes_downloaded)

nullspace volume download team-data /models/model.bin ./model.bin

# 1. Mint a signed direct download URL for the volume path.
URL=$(curl -fsS -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/download-url" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/models/model.bin"}' | jq -r .url)

# 2. Fetch the bytes from the signed URL with GET.
curl -fsS "${URL}" -o ./model.bin

volume.files.download_file("/models/model.bin", "./model.bin", overwrite=True)

nullspace volume download team-data /models/model.bin ./model.bin --force

# Overwrite is a client-side concern: the download endpoint is unchanged and
# `curl -o` simply replaces the local file.
URL=$(curl -fsS -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/download-url" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/models/model.bin"}' | jq -r .url)
curl -fsS "${URL}" -o ./model.bin

volume.files.download_dir("/datasets", "./datasets-copy", overwrite=True)

nullspace volume download team-data /datasets ./datasets-copy --force

# Directory downloads stream a tar archive: mint a download URL with
# archive_format=tar, fetch it, then extract locally.
URL=$(curl -fsS -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/download-url" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/datasets", "archive_format": "tar"}' | jq -r .url)
curl -fsS "${URL}" -o datasets.tar
mkdir -p ./datasets-copy && tar -xf datasets.tar -C ./datasets-copy

volume.files.download_dir(
    "/datasets",
    "./datasets.tar",
    archive=True,
    overwrite=True,
)

nullspace volume download team-data /datasets ./datasets.tar --archive --force --json

# Keep the tar archive by skipping the local extract step.
URL=$(curl -fsS -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/download-url" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/datasets", "archive_format": "tar"}' | jq -r .url)
curl -fsS "${URL}" -o ./datasets.tar

file_url = volume.files.download_url("/models/model.bin")
archive_url = volume.files.download_url("/datasets", archive_format="tar")

nullspace volume download-url team-data /models/model.bin
nullspace volume download-url team-data /datasets --archive-format tar

curl -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/download-url" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/models/model.bin"}'

curl -X POST "${NULLSPACE_API_URL}/v1/volumes/vol_123/files/download-url" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"path": "/datasets", "archive_format": "tar"}'