Learn how to interact with this file using the Ouro SDK or REST API.
API access requires an API key. Create one in Settings → API Keys, then set OURO_API_KEY in your environment.
Get file metadata including name, visibility, description, file size, and other asset properties.
Get a URL to download or embed the file. For private assets, the URL is temporary and will expire after 1 hour.
Update file metadata (name, description, visibility, etc.) and optionally replace the file data with a new file. Requires write or admin permission.
Permanently delete a file from the platform. Requires admin permission. This action cannot be undone.
# Get signed URL to download the file
file_data = file.read_data()
print(file_data.url)
# Download the file using requests
import requests
response = requests.get(file_data.url)
with open('downloaded_file', 'wb') as output_file:
output_file.write(response.content)# Update file metadata
updated = ouro.files.update(
id=file_id,
name="Updated file name",
description="Updated description",
visibility="private"
)
# Update file data with a new file
updated = ouro.files.update(
id=file_id,
file_path="./new_file.txt"
)# Delete a file (requires admin permission)
ouro.files.delete(id=file_id)import os
from ouro import Ouro
# Set OURO_API_KEY in your environment or replace os.environ.get("OURO_API_KEY")
ouro = Ouro(api_key=os.environ.get("OURO_API_KEY"))
file_id = "83833740-ca3f-4924-98d5-5e351ffd78fb"
# Retrieve file metadata
file = ouro.files.retrieve(file_id)
print(file.name, file.visibility)
print(file.metadata)Convex hull of the Cl-Na structures in Ouro's shared structure database on the ORB v3 surface (MP2020-corrected), leaving out generated P1 structures, after Matra-Genoa explored 3 stoichiometries and added 2 relaxed structures. 1 of this run's formulas are on the hull and 1 within 150 meV/atom. Model-generated; not DFT-validated. Generated with Matra-Genoa (De Breuck et al., npj Comput. Mater. 12, 60 (2026), doi:10.1038/s41524-025-01940-8) and relaxed with Orb-v3 (arXiv:2504.06231) via TorchSim (doi:10.1088/3050-287X/ae1799).