sandbox_sessions

Creates, updates, deletes, gets or lists a sandbox_sessions resource.

Overview

Name	sandbox_sessions
Type	Resource
Id	railway.agents.sandbox_sessions

Fields

The following fields are returned by SELECT queries:

list

One row per SandboxSession. A resumable session inside a sandbox: an interactive shell or a one-off exec command.

Name	Datatype	Description
name	string	Stable session name; reconnect/attach by this.
attached	boolean	Whether a client is currently connected.
command	string	The command being run; empty for an interactive shell.
created_at	string (date-time)
foreground_active	boolean	For an interactive shell, whether a foreground program currently holds the terminal. Null otherwise, or when the runtime can't report it.
kind	string	(EXEC, SHELL)
run_state	object	SandboxSessionRunState object

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	environment_id, id		Resumable sessions inside a sandbox — interactive shells and one-off exec commands, live or recently exited. Null when the sandbox can't report them (e.g. its vm-init predates session listing). Backed by the Railway GraphQL query sandboxSessions.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
environment_id	string
id	string

SELECT examples

list

Resumable sessions inside a sandbox — interactive shells and one-off exec commands, live or recently exited. Null when the sandbox can't report them (e.g. its vm-init predates session listing). Backed by the Railway GraphQL query sandboxSessions.

SELECT
name,
attached,
command,
created_at,
foreground_active,
kind,
run_state
FROM railway.agents.sandbox_sessions
WHERE environment_id = '{{ environment_id }}' -- required
AND id = '{{ id }}' -- required
;