---
search:
  tags:
    - sandboxes
    - POST
seo:
  description: >-
    Enforces the org's running-sandbox quota, while billing is off for the org…
    Reference for the POST /v1/sandboxes/{sandbox}/resume endpoint in the
    pols.so API.
sidebar:
  label: Resume a stopped sandbox, or wake one in standby
  badge: POST
title: Resume a stopped sandbox, or wake one in standby
type: openapi-operation
---
Enforces the org's running-sandbox quota,
while billing is off for the org its monthly sandbox-hours (403
`quota_exceeded`), and, once billing is switched on for the org (`billing_enabled` on
`/v1/balance`; on for new orgs), its balance (402
`insufficient_credit` unless it is positive) and, for a trial org
(`trial`), the trial limits: it may run one small or default sandbox at a time and hold
20 GiB of disk (403 `trial_limit`), and all trial orgs together may
reserve 8 GiB of host memory at once, overcommitted like the hosts'
(12 GiB at the default `--memory-overcommit` of 1.5; the configured
value is `trial_credit.limits.total_memory_gib` on `/v1/balance`):
a start beyond that is refused with 429
`trial_capacity` and a `Retry-After`, and may pass when retried.
While the host is short of memory, any start is refused with 429
`host_capacity` and a `Retry-After`.
Returns 409 if a conflicting lifecycle transition is pending. A
sandbox in standby counts as running already; resuming it wakes it.

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