Create notebook sessions with workspace-scoped storage, image or snapshot boot, resource controls, and kernel TTL policies. Notebook session APIs live under /notebooks/sessions, while notebook document APIs live under /notebooks.

Session Creation Fields

The current CreateNotebookSessionDto supports:
  • name
  • workspaceId
  • image or snapshotId
  • cpuMillis
  • memoryMb
  • gpuCount
  • gpuType
  • storageMode
  • env
  • idleTtlSeconds
  • snapshotFavor
  • persistent
  • hardKillAt
  • hardKillAfterSeconds

Minimal Session Example

curl -X POST https://api.agentenv.io/v1/notebooks/sessions \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "analysis-session",
    "workspaceId": "YOUR_WORKSPACE_ID",
    "image": "docker://quay.io/jupyter/datascience-notebook:notebook-7.5.5",
    "cpuMillis": 2000,
    "memoryMb": 4096,
    "storageMode": "persistent"
  }'

Beyond Sessions

The notebook resource itself also exposes document endpoints for:
  • notebook CRUD
  • cell CRUD and reordering
  • notebook file uploads/downloads
  • kernel execution, restart, keepalive, wake, and TTL policy
  • cell output inspection and clearing

API Pages