---
title: "Evaluate spawn admission"
method: POST
path: "/sandboxes/admission"
tags: ["sandboxes"]
---

# Evaluate spawn admission

`POST /sandboxes/admission`

Return whether a spawn request would be allowed, queued, or denied by quota and scheduler limits

## Request body

- GithubComStacyOsStacyvmInternalOrchestratorSpawnRequest
  - `image` string
  - `memory_mb` integer
  - `metadata` object
  - `owner_id` string
  - `provider` string
  - `template` string
  - `tenant_id` string
  - `ttl` string
  - `vcpus` integer

## Response `200`

OK

- GithubComStacyOsStacyvmInternalOrchestratorSpawnAdmissionDecision
  - `active_owner_sandboxes` integer
  - `active_sandboxes` integer
  - `allowed` boolean
  - `eligible_workers` integer
  - `max_owner_sandboxes` integer
  - `max_sandboxes` integer
  - `max_ttl` string
  - `queueable` boolean
  - `reason` string
  - `selected_worker_id` string
  - `worker_reason` string

## Other responses

- `400` — Bad Request
- `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)