Browse Documentation

Reference / sandboxes / generated

GET/v1/sandboxes/{id}

Get a sandbox.

Fetches the current provider state for one project-owned sandbox and returns it through the normalized Wildflower lifecycle model.

Operation IDgetSandbox
Success200
AuthenticationBearer key

Path parameters

getSandbox path parameters
NameTypeRequirementMeaning
idstringRequiredOpaque, project-scoped Wildflower sandbox ID returned by create. The provider namespace is visible, but the random payload does not encode the provider-native ID.

Optional provider context

These headers are inline overrides. Connected project profiles keep the same fields outside individual requests.

getSandbox header parameters
NameTypeRequirementMeaning
X-Provider-WorkspacestringOptionalOptional inline provider workspace override. Required with an inline Blaxel credential and omitted when using a connected profile.
X-Provider-Bridge-UrlstringOptionalOptional inline customer-owned bridge URL. Required with an inline Cloudflare, Modal, or AgentCore credential and omitted when using a connected profile.
X-Provider-Team-IdstringOptionalOptional inline Vercel team identifier. Required with an inline Vercel credential.
X-Provider-Project-IdstringOptionalOptional inline Vercel project identifier. Required with an inline Vercel credential.

Request and response

Request bodyNone
ResponseSandbox

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/wf_e2b_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" \  -H "Authorization: Bearer $WILDFLOWER_API_KEY"

Response / 200

200.json
{  "id": "wf_e2b_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",  "provider": "e2b",  "status": "running",  "metadata": {    "nativeProviderId": "native-1"  }}

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 sandbox = await client.sandboxes.get("wf_e2b_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA");console.log(sandbox.status, sandbox.statusObservedAt);
Pythonexample.py
example.py
import osfrom wildflower import (    E2bCreateSandboxInput,    ReadFileInput,    RunCommandInput,    WriteFileInput,    Wildflower,)client = Wildflower(    wildflower_api_key=os.environ.get("WILDFLOWER_API_KEY"),)sandbox = client.sandboxes.get("wf_e2b_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA")print(sandbox.status, sandbox.status_observed_at)
Rustexample.rs
example.rs
use wildflower::{    CreateSandboxInput, FileEncoding, ListSandboxesOptions, ReadFileInput,    RunCommandInput, WriteFileInput,    Wildflower,};let client = Wildflower::new(std::env::var("WILDFLOWER_API_KEY")?)?;let sandbox = client.sandboxes().get("wf_e2b_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA").await?;println!("{:?} {:?}", sandbox.status, sandbox.status_observed_at);
Goexample.go
example.go
client, err := wildflower.NewClient(os.Getenv("WILDFLOWER_API_KEY"))if err != nil {    return err}sandbox, err := client.Sandboxes.Get(ctx, "wf_e2b_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA")if err != nil {    return err}fmt.Println(sandbox.Status, sandbox.StatusObservedAt)
Zigexample.zig
example.zig
var client = try Wildflower.init(    allocator,    wildflower_api_key,    transport,);defer client.deinit();var sandbox = try client.get("wf_e2b_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA");defer sandbox.deinit();std.debug.print("{s}\n", .{@tagName(sandbox.value.status)});

Generated SDK methods

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