---
title: "POST /v1/pools"
method: POST
path: "/v1/pools"
tags: ["pools"]
---

# POST /v1/pools

`POST /v1/pools`

## Request body

- PoolConfig
  - `cpus` integer
  - `image` string, required
  - `maxIdleSecs` integer
  - `memoryMb` integer
  - `network` boolean
  - `targetSize` integer
  - `tenantId` string, nullable — Optional owning tenant. Admin-only: when set, the pool is private to that tenant; when omitted, the pool is shared and any tenant may claim from it.

## Response `200`

Pool created

- PoolInfo
  - `busyCount` integer, required
  - `id` string, required
  - `idleCount` integer, required
  - `image` string, required
  - `status` string, required
  - `targetSize` integer, required

---

[API](https://skmtc.net/smolmachines/apis/smolfleet-api.md) · [All operations](https://skmtc.net/smolmachines/apis/smolfleet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smolmachines/smolfleet-api/versions/853ec529472a/schema)