mountOS Admin SDK for Rust

Async Rust SDK for the mountOS provider API, built on reqwest/tokio with ED25519 JWT authentication.

Install

cargo add mountos-admin-sdk

Requires Rust 1.85+ (edition 2024). TLS uses rustls with the OS trust store, so self-hosted appserv behind a private/corporate CA works out of the box.

Usage

use mountos_admin_sdk::{Client, Config, CreateAccountRequest};

#[tokio::main]
async fn main() -> Result<(), mountos_admin_sdk::Error> {
    let client = Client::new(Config {
        base_url: "https://appserv.example.com".into(),
        private_key: "<base64 ED25519 key>".into(), // 32-byte seed or 64-byte seed+pubkey
        ..Default::default()
    })?;

    // Accounts
    let created = client.accounts.create(&CreateAccountRequest {
        name: "Acme".into(),
        description: None,
        icon_url: None,
        provider_info: None,
    }).await?;
    let account = client.accounts.get(created.id).await?;
    println!("{} (active={})", account.name, account.is_active);

    // Page-based list
    let page = client.accounts.list(None).await?;
    println!("{} accounts", page.pagination.total);

    // Volumes
    client.volumes.update_quota(created.id, &mountos_admin_sdk::UpdateVolumeQuotaRequest {
        quota_limit: 1 << 30,
    }).await?;

    Ok(())
}

Resource accessors map to client.<resource> in snake_case (client.volume_fork_trees, client.region_audit_logs, ...). Methods are async and take &self.

Error Handling

use mountos_admin_sdk::Error;

match client.accounts.get(999).await {
    Ok(account) => println!("{}", account.name),
    Err(Error::Api { message, status, error_code }) => {
        eprintln!("{message} (status={status}, code={error_code})");
    }
    Err(e) => eprintln!("transport error: {e}"),
}

Auth

private_key is a base64-encoded ED25519 key — a 32-byte seed or a 64-byte seed+public-key. JWT tokens are signed locally and cached for ~55 minutes (1h TTL with a 5-minute refresh margin); the cache is Mutex-guarded and never held across an .await.

Pass dashboard_user in Config to sign an X-MountOS-Dashboard-User header into every request for operator-scoped access.

Reference

Full API reference: docs/rust.md. Generated from api.yaml; see also the language-neutral api.md.

License

Apache-2.0