# Pools

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

A pool supplies shared CPU, RAM and storage to its Computers.

## Read

| Request | What it does |
| --- | --- |
| [List or read pools](https://heaven.dev/docs/reference/pools/view) | List accessible pools or read one pool's capacity and settings. |
| [Read a pool's usage](https://heaven.dev/docs/reference/pools/usage) | Read CPU, memory, storage and traffic history for one pool or all accessible pools. |

## Create and delete

| Request | What it does |
| --- | --- |
| [Create a pool](https://heaven.dev/docs/reference/pools/create) | Create a pool that shares CPU, RAM and storage across its Computers. |
| [Delete a pool](https://heaven.dev/docs/reference/pools/delete) | Delete a pool and its Computers, disks and snapshots. |

## Power

| Request | What it does |
| --- | --- |
| [Start a pool](https://heaven.dev/docs/reference/pools/start) | Start a stopped pool and the Computers stopped with it. |
| [Stop a pool](https://heaven.dev/docs/reference/pools/stop) | Stop a pool's Computers and free its CPU and RAM for other pools on the same server. |
| [Pause a pool](https://heaven.dev/docs/reference/pools/pause) | Pause a pool's running Computers so they can resume with their memory and processes. |
| [Resume a pool](https://heaven.dev/docs/reference/pools/resume) | Resume a paused pool and continue the Computers paused with it from their preserved memory and processes. |
| [Keep a pool running longest](https://heaven.dev/docs/reference/pools/stop-last) | Give a pool priority to keep running when paid capacity runs short. |

## Size and shape

| Request | What it does |
| --- | --- |
| [Resize a pool](https://heaven.dev/docs/reference/pools/resize) | Change a pool's shared CPU, RAM and storage. |
| [Rename a pool](https://heaven.dev/docs/reference/pools/rename) | Change a pool's name. |
| [Split a pool](https://heaven.dev/docs/reference/pools/split) | Move selected Computers and capacity into a new pool on the same server. |
| [Combine pools](https://heaven.dev/docs/reference/pools/combine) | Move another pool's Computers and capacity into this pool on the same server, then delete the source pool. |
| [Transfer a pool](https://heaven.dev/docs/reference/pools/transfer) | Transfer a pool and its Computers to another organization. |

## Defaults

| Request | What it does |
| --- | --- |
| [Set pool defaults](https://heaven.dev/docs/reference/pools/defaults-set) | Set the pool's defaults for new Computers. |
| [Clear pool defaults](https://heaven.dev/docs/reference/pools/defaults-clear) | Clear named defaults for Computers created in a pool. |

## Sharing

| Request | What it does |
| --- | --- |
| [Share a pool](https://heaven.dev/docs/reference/pools/share-add) | Grant access to create Computers in a pool. |
| [Stop sharing a pool](https://heaven.dev/docs/reference/pools/share-remove) | Revoke a pool share and access it gave to Computers created through the pool. |
