---
search:
  tags:
    - sandboxes
    - POST
seo:
  description: >-
    Enforces the same quotas as create. The fork keeps the source's egress…
    Reference for the POST /v1/sandboxes/{sandbox}/fork endpoint in the pols.so
    API.
sidebar:
  label: Fork a sandbox into a new running sandbox with a copy of its disk
  badge: POST
title: Fork a sandbox into a new running sandbox with a copy of its disk
type: openapi-operation
---
Enforces the same quotas as create. The fork keeps the source's
egress policy unless the request sets one, and the source's
environment and vault entries, plus any `secrets` the request names.
It does not inherit the source's expiry: set `ttl_seconds` to give
the fork one.

The fork boots from the copy of the disk, except on Cloud Hypervisor
(an operator opt-in per org): there a fork of a running sandbox also
gets its memory, so it runs on where the source was, with its
processes, under its own name, address, machine-id and SSH host keys.
The source pauses while its memory is copied, about 1.5 s per 8 GiB.
If the host has no room for the memory, the fork boots from the disk.

`POST /v1/sandboxes/{sandbox}/fork`