Storage

TouAI Storage provides Data Lakehouse object storage with both a simple API and organization-scoped APIs.

Simple API

Use the simple API when you want the SDK to resolve the default workspace, project, and bucket automatically.

stored = client.storage.store(open("data.csv", "rb"))
print(stored.key)
 
stored = client.storage.store_text(
    '{"users": [{"name": "Alice"}]}',
    "data.json",
)
 
files = client.storage.files(prefix="data/")
url = client.storage.download_url("data/file.csv", expires_in=3600)
info = client.storage.file_info("data/file.csv")
client.storage.delete_file("data/old.csv")
overview = client.storage.info()

Method	Return Type	Description
`store(file)`	`StoredObject`	Upload a binary file
`store_text(content, filename)`	`StoredObject`	Store text or JSON
`files(prefix=...)`	`list[StoredFile]`	List files
`download_url(key)`	`str`	Get a pre-signed download URL
`file_info(key)`	`FileInfo`	Get file metadata
`delete_file(key)`	`None`	Delete a file
`info()`	`StorageInfo`	Storage overview

Full API

Projects

projects = client.storage.projects.list("org-id")
project = client.storage.projects.create("org-id", "Analytics", description="...")
project = client.storage.projects.get("org-id", "project-id")
client.storage.projects.update("org-id", "project-id", name="Renamed")
client.storage.projects.delete("org-id", "project-id")
 
members = client.storage.projects.members("org-id", "project-id")
client.storage.projects.add_member("org-id", "project-id", "user-id", role="editor")
client.storage.projects.update_member("org-id", "project-id", "member-id", role="admin")
client.storage.projects.remove_member("org-id", "project-id", "member-id")

Buckets

bucket = client.storage.buckets.create("org-id", "project-id", "raw-data")
buckets = client.storage.buckets.list("org-id", "project-id")
bucket = client.storage.buckets.get("org-id", "bucket-id")
client.storage.buckets.update("org-id", "bucket-id", name="renamed")
client.storage.buckets.delete("org-id", "bucket-id")

Objects

client.storage.objects.upload("org-id", "bucket-id", open("file.csv", "rb"), path="data/")
 
signed = client.storage.objects.upload_signed_url(
    "org-id",
    "bucket-id",
    "reports/q1.pdf",
    "application/pdf",
)
 
page = client.storage.objects.list(
    "org-id",
    "bucket-id",
    prefix="reports/",
    delimiter="/",
    limit=100,
)
 
url = client.storage.objects.download("org-id", "bucket-id", "reports/q1.pdf")
info = client.storage.objects.info("org-id", "bucket-id", "reports/q1.pdf")
client.storage.objects.delete("org-id", "bucket-id", "reports/q1.pdf")
client.storage.objects.bulk_delete("org-id", "bucket-id", ["old1.csv", "old2.csv"])

Personal Storage

projects = client.storage.my.projects.list()
project = client.storage.my.projects.create("My Project")
 
buckets = client.storage.my.buckets.list("project-id")
bucket = client.storage.my.buckets.create("project-id", "my-bucket")
 
client.storage.my.objects.upload("bucket-id", open("file.csv", "rb"))
objects = client.storage.my.objects.list("bucket-id", prefix="data/")
url = client.storage.my.objects.download("bucket-id", "data/file.csv")
info = client.storage.my.objects.info("bucket-id", "data/file.csv")
client.storage.my.objects.delete("bucket-id", "data/file.csv")
client.storage.my.objects.bulk_delete("bucket-id", ["old1.csv", "old2.csv"])

Data Search Billing