Skip to main content
An App is the application that owns your sailboxes. Every Sailbox.create call needs an app, usually resolved by name with App.find(). 
import sail

app = sail.App.find(name="example-app", mint_if_missing=True)
print(app.id, app.name)

import { App } from "@sailresearch/sdk";

const app = await App.find("example-app", { mintIfMissing: true });
console.log(app.id, app.name);

use sail::Client;

let client = Client::from_env()?;
let app = client.find_app("example-app", /* mint_if_missing */ true).await?;
println!("{} {}", app.id, app.name);

​
App.find

@classmethod
def find(*, name: str, mint_if_missing: bool = False) -> App

static find(name: string, options?: { mintIfMissing?: boolean }): Promise<App>

pub async fn find_app(&self, name: &str, mint_if_missing: bool) -> Result<App, SailError>
Finds an app by name, optionally creating it if it does not exist.
ParameterDefaultDescription
namerequiredThe app name to look up.
mint_if_missingFalseCreate the app if no app with that name exists.
Returns the App. Raises a not-found error if the app does not exist and mint_if_missing is False, and a permission error on auth failures.

​
App.list

@classmethod
def list() -> list[App]

static list(): Promise<App[]>

pub async fn list_apps(&self) -> Result<Vec<App>, SailError>
Returns every app the current org owns, newest first. Apps with no sailboxes yet are included. The response is not paginated.

​
Attributes

AttributeTypeDescription
idstrStable app identifier.
namestrApp name.
created_atintCreation timestamp.