---
title: "Extend sandbox TTL"
method: POST
path: "/sandboxes/{sandboxID}/extend"
tags: ["sandboxes"]
---

# Extend sandbox TTL

`POST /sandboxes/{sandboxID}/extend`

Add additional time to a sandbox's expiration

## Path parameters

- `sandboxID` string, required

## Request body

- object
  - `ttl` string

## Response `200`

OK

- GithubComStacyOsStacyvmInternalOrchestratorSandbox
  - `created_at` string
  - `expires_at` string
  - `id` string
  - `image` string
  - `memory_mb` integer
  - `metadata` object
  - `owner_id` string
  - `preview_domain` string
  - `provider` string
  - `state` 'creating' | 'running' | 'idle' | 'unhealthy' | 'expired' | 'destroyed' | 'error'
  - `tenant_id` string
  - `vcpus` integer
  - `vm_id` string
  - `worker_id` string

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/stacyos/apis/stacyvm-api.md) · [All operations](https://skmtc.dev/stacyos/apis/stacyvm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stacyos/stacyvm-api/revisions/d8b1ebf10293/schema)