LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
LangSmith
  • Client
  • Run Trees
  • Traceable
  • Evaluation
  • Schemas
  • Langchain
  • Jest
  • Vitest
  • Wrappers
  • Anonymizer
  • Jestlike
  • Vercel
  • Anthropic
  • Sandbox
⌘I

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

Menu

LangSmith
ClientRun TreesTraceableEvaluationSchemasLangchainJestVitestWrappersAnonymizerJestlikeVercelAnthropicSandbox
Language
Theme
JavaScriptlangsmithsandboxSandboxData
Interface●Since v0.8

SandboxData

Data representing a sandbox instance from the API.

Copy
interface SandboxData

Properties

property
created_at: string

Timestamp when the sandbox was created.

property
dataplane_url: string

URL for data plane operations (file I/O, command execution).

property
delete_after_stop_seconds: number

Seconds after the sandbox enters the stopped state before it (and its filesystem clone) are permanently deleted (0 means disabled).

property
fs_capacity_bytes: number

Root filesystem capacity in bytes.

property
id: string

Optionally, a unique identifier for the run.

property
idle_ttl_seconds: number

Idle timeout TTL in seconds (0 means disabled). New sandboxes receive a server-side default of 600 seconds (10 minutes) when the caller did not set idleTtlSeconds explicitly. The launcher stops the sandbox after this many idle seconds.

property
mem_bytes: number

Memory allocation in bytes.

property
name: string

A human-readable name for the run.

property
snapshot_id: string

Snapshot ID used to create this sandbox.

property
status: string

Provisioning status ("provisioning", "ready", "failed", "stopped").

property
status_message: string

Human-readable status message (e.g., error details when failed).

property
stopped_at: string

Timestamp when the sandbox transitioned to stopped, or undefined while running. The deletion deadline is stopped_at + delete_after_stop_seconds.

property
updated_at: string

Timestamp when the sandbox was last updated.

property
vcpus: number

Number of vCPUs allocated.

View source on GitHub