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 the kernel starts in. Empty falls 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 language, one of python, typescript or javascript. A language is required: shell, or omitting the field, answers 400 UNSUPPORTED_OPERATION, because shell sessions are created with POST /processes kind=session.
login?booleanNot used by language kernels; answers 400 UNSUPPORTED_OPERATION when true.
shell?|Not used by language kernels; answers 400 UNSUPPORTED_OPERATION when set.
application/json- response
Session DTO returned by create/list/get.
active*booleanWhether the backing kernel is active.
createdAt*stringRFC 3339 creation timestamp.
cwd*stringWorking directory the kernel started in (a kernel's own chdir is not tracked).
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*stringWorking directory the kernel started in (a kernel's own chdir is not tracked).
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'