DEdeepnote
Machines

Restart a project's editor machine

Changed on

Stops the project machine and starts a new one, which recovers a machine in the error status. Kernel state, such as variables, is lost for everyone working in the project. Returns without waiting for the new machine to boot; poll GET /projects/{projectId}/machine until the status is running. Restarting a stopped machine starts it. This is the machine the editor, live-mode runs and hosted Streamlit apps use; machines of detached runs and interactive sessions are not affected.

post/projects/{projectId}/machine/restart

Request

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

Path parameters

projectIdstring uuid required

ID of the project whose machine to use.

Response

Machine restart 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