Files

List directories, upload files, and (Java) download content. File metadata travels in X-Datahub-* headers, which the SDK percent-encodes for you.

List

Java

DataWrapper<IndexNode> root = client.files().list();
DataWrapper<IndexNode> reports = client.files().list("/reports/2026");

Python

roots = client.files.list_root_directory()
listing = client.files.list_directory_by_path("/reports/2026")

Rust

let roots = api.files.list_root_directory().await?;
let listing = api.files.list_directory_by_path("/reports/2026").await?;

Upload

The Java client uploads raw content bytes to a destination path; the Python and Rust clients upload a local file and a destination_path.

Java

byte[] content = Files.readAllBytes(Path.of("report.csv"));

DataWrapper<IndexNode> uploaded = client.files().upload(
        FileUploadRequest.builder()
                .path("reports/2026/q2.csv")
                .content(content)
                .contentType("text/csv")        // default: application/octet-stream
                .externalId("report_2026_q2")   // optional
                .dataSetId(42L)                 // optional
                .description("Q2 production")   // optional
                .build());

Python

import datahub_sdk

upload = datahub_sdk.FileUpload(
    path="report.csv",                 # local file
    destination_path="/reports/2026/",
    external_id="report_2026_q2",
    name="q2.csv",
    data_set_id=42,
    description="Q2 production")

uploaded = client.files.upload_file(upload)   # -> list[INode]

Rust

use dataplatform_rust_sdk::files::FileUpload;

// mime type is inferred from the file content
let mut upload = FileUpload::new_with_destination_path("report.csv", "/reports/2026/");
upload.set_external_id("report_2026_q2".into());
upload.set_file_name("q2.csv".into());
upload.set_data_set_id(42);
upload.set_description("Q2 production".into());
let uploaded = api.files.upload_file(upload).await?;

Download (Java)

The Java client downloads a file's raw bytes by id:

byte[] bytes = client.files().download("99");
Files.write(Path.of("q2.csv"), bytes);

Delete

Java

client.files().delete(List.of(IdCollection.createFromExternalId("report_2026_q2")));

Python

client.files.delete(["report_2026_q2"])

Rust

use dataplatform_rust_sdk::generic::{DataWrapper, IdAndExtId};

api.files.delete(&DataWrapper::from(vec![IdAndExtId::from_external_id("report_2026_q2")])).await?;