latestOpenAPI 3.1.02026-08-204489152.5 KB

726970fd2992

Sessions

Create an interactive session

Creates an interactive session that runs the specified notebook and stays alive to accept further submissions. The session executes its own copy of the notebook (see sessionNotebookId); edit that copy via the standard notebook and block endpoints to change what subsequent runs execute — the source notebook is never modified. The session ends after a period of inactivity.

post/sessions

Request body

notebookIdstring required

ID of the source notebook the session is anchored to.

inputsobject

Input values for the initial run, keyed by input block name. Same shape as POST /v2/runs.

storageMode'read_write' | 'readonly'

Storage mode for the session. read_write (default) allows the session to write to project storage. readonly makes project storage read-only for the session; the session can still create temporary files.

Response

Session created with initial run