DEdeepnote
Machines

Start a project's editor machine

Changed on

Starts the project machine and returns without waiting for it to boot; poll GET /projects/{projectId}/machine until the status is running. Starting a machine that is already starting or running does nothing and succeeds. Running a notebook in live mode starts the machine too. This is the machine the editor, live-mode runs and hosted Streamlit apps use; detached runs and interactive sessions start machines of their own, so there is no need to start this one for them.

post/projects/{projectId}/machine/start

Request

  • Base URL
    https://api.deepnote.com/v2
  • URL
    https://api.deepnote.com/v2/projects/{projectId}/machine/start
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

ID of the project whose machine to use.

Response

Machine start accepted

Example response

{
  "machine": {
    "status": "running",
    "startingPhase": "pulling_image",
    "type": {
      "id": "fjord",
      "name": "CPU (Plus)",
      "type": "deepnote",
      "vCpus": 4,
      "memoryGiB": 16
    },
    "sandboxEnvironmentId": "deepnote",
    "idleShutdownSeconds": 900
  }
}

Changes

  • 062f5f1b4638Revision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • info

      response property machine/error list-of-types was narrowed by removing types null from media type application/json of response 202

    • info

      response property machine/sandboxEnvironmentId list-of-types was narrowed by removing types null from media type application/json of response 202

  • df3d4eb06bcfRevision changes
    • info

      added the required property / to the response with the status