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 ID
getSandboxSuccess200
AuthenticationBearer key
Path parameters
| Name | Type | Requirement | Meaning |
|---|---|---|---|
id | string | Required | Opaque, 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.
| Name | Type | Requirement | Meaning |
|---|---|---|---|
X-Provider-Workspace | string | Optional | Optional inline provider workspace override. Required with an inline Blaxel credential and omitted when using a connected profile. |
X-Provider-Bridge-Url | string | Optional | Optional inline customer-owned bridge URL. Required with an inline Cloudflare, Modal, or AgentCore credential and omitted when using a connected profile. |
X-Provider-Team-Id | string | Optional | Optional inline Vercel team identifier. Required with an inline Vercel credential. |
X-Provider-Project-Id | string | Optional | Optional 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
curl --fail-with-body --request GET \ "$WILDFLOWER_URL/v1/sandboxes/wf_e2b_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" \ -H "Authorization: Bearer $WILDFLOWER_API_KEY"Response / 200
{ "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
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
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
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
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
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.
