---
title: "Initialize the simulation"
method: PUT
path: "/initialize/{testid}"
tags: ["Test Setup"]
---

# Initialize the simulation

`PUT /initialize/{testid}`

Initialize simulation to a start time using a warmup period (also resets history and KPI calculations).

## Request body

- object
  - `start_time` number, required — Start time (seconds since Jan 1st, 00:00:00) to initialize the simulation to.
  - `warmup_period` number, required — Warmup period in seconds.

## Response `200`

Simulation initialized successfully.

- SimResponse
  - `message` string — A message describing the response.
  - `payload` object — Current values of all input and measurement signals; always includes "time".
    - `time` number, required — Current simulation time (seconds since Jan 1st, 00:00:00).
  - `status` integer — HTTP status code.

---

[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/ecdfc7b011f7/schema)