Lifecycle
Restart computer
Reboot a running computer.
POST
Restart computer
Reboots a computer in place on the host it is already running on. The disk is untouched; memory and running processes are not.
Restarting a
Poll
A restart keeps the computer’s ports and VNC password. Orgo rewrites the stored connection details from what the host reports afterwards, so re-fetch
GET /computers/{id} if you need to be certain. Open VNC and terminal WebSockets drop during the reboot.frozen computer, or a stopped one with no virtual machine, returns 409 with code stopped, because it has no host. Use start instead. A stopped computer whose virtual machine is still on its host is booted there, which requires a plan that funds running computers.
Path parameters
Optional body
Used only by a dedicated GPU computer whose restart recreates the machine. That restart deletes everything outside
/workspace, including /root, so send true to confirm it. Without it the request returns 409 with code RESTART_CLEARS_DISK. Every other computer needs no body.Response
true when the computer restarted. The response is sent after the reboot completes, not when it is queued. A dedicated GPU computer answers 202 first, as described in Restart a dedicated GPU computer.Use cases
- Recover from a hung or unresponsive computer
- Reset the running environment
Example
Response
Restart a dedicated GPU computer
A dedicated GPU computer whose restart recreates the machine answers202 as soon as the restart has started:
poll_url, also sent as Location, as described in Get operation. When the operation succeeds, its result.ssh has the computer’s new SSH endpoint, as host, port, and command. The port changes on every restart.
Errors
A failed restart changes the computer’s status only to what its host confirms, such as
stopped or error. When the host cannot be reached, the computer keeps the status it had before the call.Authorizations
Body
application/json