Deepnote Public API v2

Sessions API

Long-lived interactive sessions for running notebooks and blocks.

Base URL

https://api.deepnote.com/v2

Create an interactive session

Creates an interactive session that runs the specified notebook and stays alive to accept further submissions. The session ends after a period of inactivity.

post/sessions

Request body

required

application/jsonobject

notebookIdrequiredstring

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.

Responses

▸202Session created with initial run

application/jsonCreateSessionResponse

sessionrequiredSession

runrequiredobject

▸400Validation error