# Computers

URL: https://heaven.dev/docs/reference/computers
Updated: 2026-11-21

A Computer is a persistent Linux virtual machine with root access, running in a pool.

## Read

| Request | What it does |
| --- | --- |
| [List or read Computers](https://heaven.dev/docs/reference/computers/view) | List accessible Computers or read a named Computer. |
| [Read a Computer's usage](https://heaven.dev/docs/reference/computers/usage) | Read CPU, memory, disk and network history for one Computer. |
| [Read the boot console](https://heaven.dev/docs/reference/computers/logs) | Read a Computer's boot console output. |

## Create and delete

| Request | What it does |
| --- | --- |
| [Create a Computer](https://heaven.dev/docs/reference/computers/create) | Create persistent Linux Computers with root access in a pool. |
| [Delete Computers](https://heaven.dev/docs/reference/computers/delete) | Delete Computers and their disks and snapshots without a confirmation prompt. |

## Power

| Request | What it does |
| --- | --- |
| [Start a Computer](https://heaven.dev/docs/reference/computers/start) | Start a stopped Computer from its disk. |
| [Stop a Computer](https://heaven.dev/docs/reference/computers/stop) | Shut down a Computer and end its running processes. |
| [Restart a Computer](https://heaven.dev/docs/reference/computers/restart) | Reboot a Computer or start it if it is stopped. |
| [Pause a Computer](https://heaven.dev/docs/reference/computers/pause) | Pause a Computer so you can resume it with its memory and processes. |
| [Resume a Computer](https://heaven.dev/docs/reference/computers/resume) | Continue a paused Computer from its preserved memory and processes. |
| [Reinstall a Computer](https://heaven.dev/docs/reference/computers/reset) | Replace a Computer's disk with a fresh image and start it with its setup script. |

## Name, pool and size

| Request | What it does |
| --- | --- |
| [Rename a Computer](https://heaven.dev/docs/reference/computers/rename) | Change a Computer's name and its website, SSH and mail addresses. |
| [Move a Computer](https://heaven.dev/docs/reference/computers/move) | Move a Computer to another pool in the same account and on the same server. |
| [Resize a Computer](https://heaven.dev/docs/reference/computers/resize) | Change a Computer's CPU, memory or disk size without restarting it. |
| [Tag a Computer](https://heaven.dev/docs/reference/computers/tag) | Add or remove a Computer's tags. |
| [List tags](https://heaven.dev/docs/reference/computers/tag-view) | List tags in use on an organization's Computers in name order. |
| [Comment on a Computer](https://heaven.dev/docs/reference/computers/comment) | Replace or clear a Computer's comment. |

## Terminal and desktop

| Request | What it does |
| --- | --- |
| [Open the browser terminal](https://heaven.dev/docs/reference/computers/terminal) | Get a browser terminal link for a Computer you own or have root access to. |
| [Open the desktop](https://heaven.dev/docs/reference/computers/desktop) | Get a browser desktop link for a running Computer you own or have root access to. |

## Sharing

| Request | What it does |
| --- | --- |
| [Read who has access](https://heaven.dev/docs/reference/computers/access) | Read a Computer's HTTPS address, website access, shares and share-link status. |
| [Share a Computer](https://heaven.dev/docs/reference/computers/share-add) | Share a Computer with specific people, a team or the whole organization. |
| [Stop sharing a Computer](https://heaven.dev/docs/reference/computers/share-remove) | Remove or reduce the access granted by a Computer share. |
| [Create a share link](https://heaven.dev/docs/reference/computers/share-link-add) | Create a link that opens a Computer's main website without requiring the visitor to sign in. |
| [Remove a share link](https://heaven.dev/docs/reference/computers/share-link-remove) | Revoke a Computer's website share link and end the browser sessions opened through it. |
| [Transfer a Computer](https://heaven.dev/docs/reference/computers/transfer) | Transfer ownership of a Computer. |
| [Give support root access](https://heaven.dev/docs/reference/computers/grant-support-root) | Allow or revoke Heaven support's root access to a Computer. |

## Website and ports

| Request | What it does |
| --- | --- |
| [Set who reaches the website](https://heaven.dev/docs/reference/computers/website) | Set who can open a Computer's main HTTPS website and which HTTP port it serves. |
| [List public ports](https://heaven.dev/docs/reference/computers/port-view) | List published TCP ports and the remaining allowance, including how many new ports a pool can add in a 24-hour window. |
| [Publish a port](https://heaven.dev/docs/reference/computers/port-add) | Publish a Computer's TCP service on an assigned public port. |
| [Close a port](https://heaven.dev/docs/reference/computers/port-remove) | Close a published TCP port to new connections. |

## Email

| Request | What it does |
| --- | --- |
| [Read mail settings](https://heaven.dev/docs/reference/computers/mail-view) | Read whether a Computer can receive mail, its policy for outgoing recipients and whether sending is suspended. |
| [Change mail settings](https://heaven.dev/docs/reference/computers/mail) | Change a Computer's incoming mail settings or choose who it can send mail to. |
| [Read a message's delivery](https://heaven.dev/docs/reference/computers/mail-status) | Read the delivery status of an outgoing message by the ID returned when the Computer sent it. |
