@runloop/api-client - v1.4.0
    Preparing search index...

    Interface DevboxView

    A Devbox represents a virtual development environment. It is an isolated sandbox that can be given to agents and used to run arbitrary code such as AI generated code.

    interface DevboxView {
        id: string;
        capabilities: (
            "unknown"
            | "computer_usage"
            | "browser_usage"
            | "docker_in_docker"
        )[];
        create_time_ms: number;
        end_time_ms: number | null;
        launch_parameters: LaunchParameters;
        metadata: { [key: string]: string };
        state_transitions: StateTransition[];
        status:
            | "shutdown"
            | "initializing"
            | "running"
            | "provisioning"
            | "suspending"
            | "suspended"
            | "resuming"
            | "failure";
        blueprint_id?: string
        | null;
        failure_reason?:
            | "out_of_memory"
            | "out_of_disk"
            | "execution_failed"
            | null;
        gateway_specs?: { [key: string]: GatewaySpecs }
        | null;
        initiator_id?: string | null;
        initiator_type?: "unknown" | "api" | "scenario" | "scoring_validation";
        name?: string | null;
        shutdown_reason?:
            | "api_shutdown"
            | "keep_alive_timeout"
            | "entrypoint_exit"
            | "idle"
            | null;
        snapshot_id?: string
        | null;
        tunnel?: DevboxView.Tunnel | null;
    }
    Index

    Properties

    id capabilities create_time_ms end_time_ms launch_parameters metadata state_transitions status blueprint_id? failure_reason? gateway_specs? initiator_id? initiator_type? name? shutdown_reason? snapshot_id? tunnel?

    Properties

    id: string

    The ID of the Devbox.

    capabilities: (
        "unknown"
        | "computer_usage"
        | "browser_usage"
        | "docker_in_docker"
    )[]

    A list of capability groups this devbox has access to. This allows devboxes to be compatible with certain tools sets like computer usage APIs.

    create_time_ms: number

    Creation time of the Devbox (Unix timestamp milliseconds).

    end_time_ms: number | null

    The time the Devbox finished execution (Unix timestamp milliseconds). Present if the Devbox is in a terminal state.

    launch_parameters: LaunchParameters

    The launch parameters used to create the Devbox.

    metadata: { [key: string]: string }

    The user defined Devbox metadata.

    state_transitions: StateTransition[]

    A list of state transitions in order with durations

    status:
        | "shutdown"
        | "initializing"
        | "running"
        | "provisioning"
        | "suspending"
        | "suspended"
        | "resuming"
        | "failure"

    The current status of the Devbox.

    blueprint_id?: string | null

    The Blueprint ID used in creation of the Devbox, if the devbox was created from a Blueprint.

    failure_reason?: "out_of_memory" | "out_of_disk" | "execution_failed" | null

    The failure reason if the Devbox failed, if the Devbox has a 'failure' status.

    gateway_specs?: { [key: string]: GatewaySpecs } | null

    [Beta] Gateway specifications configured for this devbox. Map key is the environment variable prefix (e.g., 'GWS_ANTHROPIC').

    initiator_id?: string | null

    The ID of the initiator that created the Devbox.

    initiator_type?: "unknown" | "api" | "scenario" | "scoring_validation"

    The type of initiator that created the Devbox.

    name?: string | null

    The name of the Devbox.

    shutdown_reason?:
        | "api_shutdown"
        | "keep_alive_timeout"
        | "entrypoint_exit"
        | "idle"
        | null

    The shutdown reason if the Devbox shutdown, if the Devbox has a 'shutdown' status.

    snapshot_id?: string | null

    The Snapshot ID used in creation of the Devbox, if the devbox was created from a Snapshot.

    tunnel?: DevboxView.Tunnel | null

    V2 tunnel information if a tunnel was created at launch time or via the createTunnel API.

    Settings

    Member Visibility

    On This Page

    Properties