---
title: "Initialize the simulation"
method: PUT
path: "/initialize/{testid}"
---

# Initialize the simulation

`PUT /initialize/{testid}`

Initializes the simulation with a start time and warmup period.

## Request body

- object
  - `start_time` number — The start time of the simulation (epoch time).
  - `warmup_period` number — The warmup period for the simulation in seconds.

## Response `200`

Successful response indicating the simulation was initialized.

- object
  - `message` string
  - `payload` string — Confirmation message.
  - `status` integer

## Changes

- **2025-11-18** `60d61eda81c7` — 2 breaking, 3 info
  - the `payload` response's property type changed from `object` to `string` for status `200`
  - removed the required property `payload/time` from the response with the `200` status
  - api tag `Test Setup` removed
  - the request property `start_time` became optional
  - …1 more

[Change history](https://skmtc.dev/ibpsa/apis/boptest-service-api/changes/initialize/:testid/put.md)

---

[API](https://skmtc.dev/ibpsa/apis/boptest-service-api.md) · [All operations](https://skmtc.dev/ibpsa/apis/boptest-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibpsa/boptest-service-api/revisions/60d61eda81c7/schema)