Sessions
List session execution hosts in creation order.
application/json- response
GET /sessions response body.
items*array<>Sessions in creation order.
curl -X GET 'http://sandbox:2280/sessions'{ "items": [ { "active": true, "createdAt": "string", "cwd": "string", "id": "string", "kernel": "shell", "kernelProcessId": "string", "processIds": [ "string" ] } ]}Create a long-lived execution host such as a shell session or a language-kernel session.
application/json- body
POST /sessions request body.
cwd?|Working directory for the session. Empty falls back to the configured default OS user's home for shell sessions (which run as that user) when the home exists; kind=code sessions and a missing home fall back to the daemon work dir.
env?Environment overrides applied when the kernel starts.
id?|Optional client-chosen session id. Must be a safe identifier when present.
kernel?|Kernel kind. Omitted means shell.
login?booleanWhether to request a login shell.
shell?|Requested shell path or name for shell sessions.
application/json- response
Session DTO returned by create/list/get.
active*booleanWhether the backing kernel is active.
createdAt*stringRFC 3339 creation timestamp.
cwd*stringCurrent session working directory.
id*stringStable session id.
kernel*KernelKindKernel kind.
"shell""python""typescript""javascript"kernelProcessId*stringId of the long-lived kernel process backing this session.
processIds*array<string>Member process ids in creation order.
curl -X POST 'http://sandbox:2280/sessions' \ -H 'Content-Type: application/json' \ -d '{}'{ "active": true, "createdAt": "string", "cwd": "string", "id": "string", "kernel": "shell", "kernelProcessId": "string", "processIds": [ "string" ]}Fetch a session by id.
id*stringSession id.
application/json- response
Session DTO returned by create/list/get.
active*booleanWhether the backing kernel is active.
createdAt*stringRFC 3339 creation timestamp.
cwd*stringCurrent session working directory.
id*stringStable session id.
kernel*KernelKindKernel kind.
"shell""python""typescript""javascript"kernelProcessId*stringId of the long-lived kernel process backing this session.
processIds*array<string>Member process ids in creation order.
curl -X GET 'http://sandbox:2280/sessions/string'{ "active": true, "createdAt": "string", "cwd": "string", "id": "string", "kernel": "shell", "kernelProcessId": "string", "processIds": [ "string" ]}Delete a session, its backing kernel, and any member records that belong to it.
id*stringSession id.
Session deleted.
curl -X DELETE 'http://sandbox:2280/sessions/string'