---
title: "Add one deterministic population batch"
method: POST
path: "/api/control/population"
tags: ["Operator"]
---

# Add one deterministic population batch

`POST /api/control/population`

## Request

- Base URL: `https://sim.animahealth.com`
- URL: `https://sim.animahealth.com/api/control/population`
- Auth: HTTP bearer

## Query parameters

- `world` string

## Request body

- object
  - `target` integer, required
  - `batchSize` integer

## Response `200`

Success

- object
  - `world` string, required
  - `population` integer, required
  - `resources` integer, required
  - `target` integer, required
  - `complete` boolean, required
  - `generator` string, required

## Other responses

- `400`: Invalid input or unsupported workflow
- `401`: Missing or invalid credentials
- `403`: Scope, origin or operator restriction
- `404`: Unknown resource
- `409`: Stale version, invalid transition or unavailable capacity
- `413`: Request exceeds this operation's body-size limit
- `429`: Deployment has reached its 5,000-team capacity
- `500`: Internal simulation error

---

[API](https://skmtc.dev/animahealth/apis/nhs-sim-api.md) - [All operations](https://skmtc.dev/animahealth/apis/nhs-sim-api/llms.txt) - [OpenAPI document](https://skmtc.dev/animahealth/apis/nhs-sim-api/revisions/c7803d7a3e58?raw)