---
title: "Spawn from template"
method: POST
path: "/templates/{name}/spawn"
tags: ["templates"]
---

# Spawn from template

`POST /templates/{name}/spawn`

Create a new sandbox using a template's configuration, with optional overrides

## Path parameters

- `name` string, required

## Request body

- InternalApiRoutesTemplateSpawnOverrides
  - `provider` string
  - `ttl` string

## Response `201`

Created

- 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

- `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)