Wildflower Computer
Open console
Browse Documentation

Wildflower Documentation

Search the contract.

Search human guides and generated API references from one index.

View as MarkdownOpen this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in CursorSend this page to Cursor chatDownload OpenAPIUse the machine-readable contract

Reference / sandboxes / generated

GET/v1/sandboxes

List project sandboxes.

Returns project-scoped registry records in newest-first order, including deleted tombstones. This endpoint never calls a sandbox provider; status is the last provider state observed by Wildflower Computer and statusObservedAt describes its freshness.

Operation IDlistSandboxes
Success200
AuthenticationBearer key

Query parameters

listSandboxes query parameters
NameTypeRequirementMeaning
cursorstringOptionalOpaque cursor returned as nextCursor by the previous page.
limitintegerOptionalMaximum records to return. Defaults to 50.

Request and response

Request bodyNone
ResponseSandboxPage

HTTP example

This credential-safe request and its representative success response are generated with the operation contract. Replace placeholder IDs and read secrets from your environment.

Request

terminal
curl --fail-with-body --request GET \  "$WILDFLOWER_URL/v1/sandboxes?limit=2" \  -H "Authorization: Bearer $WILDFLOWER_API_KEY"

Response / 200

200.json
{  "items": [    {      "id": "wf_e2b_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",      "provider": "e2b",      "status": "running",      "metadata": {        "nativeProviderId": "native-1"      },      "createdAt": "2026-07-28T12:00:00Z",      "updatedAt": "2026-07-28T12:00:00Z",      "statusObservedAt": "2026-07-28T12:00:00Z"    }  ],  "nextCursor": "next-page"}

SDK examples

Use the same operation through any generated client. Each snippet comes from the SDK generator rather than a hand-copied website example.

TypeScriptexample.ts
example.ts
import { Wildflower } from "@wildflowercomputer/sdk";const client = new Wildflower({  wildflowerApiKey: process.env.WILDFLOWER_API_KEY,});const page = await client.sandboxes.list({ limit: 2 });console.log(page.items, page.nextCursor);
Pythonexample.py
example.py
import osfrom wildflower import (    E2bCreateSandboxInput,    ReadFileInput,    RunCommandInput,    WriteFileInput,    Wildflower,)client = Wildflower(    wildflower_api_key=os.environ.get("WILDFLOWER_API_KEY"),)page = client.sandboxes.list(limit=2)print(page.items, page.next_cursor)
Rustexample.rs
example.rs
use wildflower::{    CreateSandboxInput, FileEncoding, ListSandboxesOptions, ReadFileInput,    RunCommandInput, WriteFileInput,    Wildflower,};let client = Wildflower::new(std::env::var("WILDFLOWER_API_KEY")?)?;let page = client.sandboxes().list_page(&ListSandboxesOptions {    cursor: None,    limit: Some(2),}).await?;println!("{:?} {:?}", page.items, page.next_cursor);
Goexample.go
example.go
client, err := wildflower.NewClient(os.Getenv("WILDFLOWER_API_KEY"))if err != nil {    return err}limit := 2page, err := client.Sandboxes.List(ctx, &wildflower.ListSandboxesOptions{    Limit: &limit,})if err != nil {    return err}fmt.Println(page.Items, page.NextCursor)
Zigexample.zig
example.zig
var client = try Wildflower.init(    allocator,    wildflower_api_key,    transport,);defer client.deinit();var page = try client.listSandboxes(.{ .limit = 2 });defer page.deinit();std.debug.print("{any}\n", .{page.value.items});

Generated SDK methods

Every name below comes from the generator mapping for this operation, so a language-specific rename creates website drift.

TypeScriptlistPythonlistRustlistGoListZiglist