---
title: "Get Placements"
method: POST
path: "/platform/placements"
tags: ["Platform"]
---

# Get Placements

`POST /platform/placements`

Simulates placing the specified number of machines into regions, depending on available capacity and limits.

## Request body

- MainGetPlacementsRequest
  - `compute` FlyMachineGuest
    - `cpu_kind` string
    - `cpus` integer
    - `gpu_kind` string
    - `gpus` integer
    - `host_dedication_id` string
    - `kernel_args` string[]
    - `max_memory_mb` integer
    - `memory_mb` integer
    - `persist_rootfs` 'never' | 'always' | 'restart' — Deprecated: use MachineConfig.Rootfs instead
  - `count` integer — Number of machines to simulate placement. Defaults to 0, which returns the org-specific limit for each region.
  - `org_slug` string, required
  - `region` string — Region expression for placement as a comma-delimited set of regions or aliases. Defaults to "[region],any", to prefer the API endpoint's local region with any other region as fallback.
  - `volume_name` string
  - `volume_size_bytes` integer
  - `weights` PlacementWeights

## Response `200`

OK

- MainGetPlacementsResponse
  - `regions` PlacementRegionPlacement[]
    - `concurrency` integer
    - `count` integer
    - `region` string

---

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