---
title: "New simulation run"
method: POST
path: "/simulations/{sim_identifier}/runs"
tags: ["basic"]
---

# New simulation run

`POST /simulations/{sim_identifier}/runs`

## Path parameters

- `sim_identifier` integer, required

## Request body

- SimulationRunDetailed
  - `detail_type` string, required
  - `identifier` integer, required
  - `success` boolean, required
  - `description` string, required
  - `duration` number, required
  - `bag_name` string
  - `bag_store_name` string
  - `results` object, required — Configuration of the simulation.
  - `bag` BagSummary
    - `detail_type` string, required
    - `name` string, required
    - `store_data` object, required — Data that is specific to the bag store type.
    - `discovered` string, date-time, required — Date and time this bag was discovered.
    - `extraction_failure` boolean — True if the extraction failed
    - `in_trash` boolean — True if the bag is in the trash bin.
    - `is_extracted` boolean, required — True if data is extracted from this bag.
    - `meta_available` boolean, required — True if meta data is known for this bag.
    - `size` integer — Size of the bag in bytes.
    - `start_time` string, date-time — Start time of this bag.
    - `end_time` string, date-time — Start time of this bag.
    - `duration` number — duration of this bag in seconds.
    - `messages` integer — Number of messages in this bag.
    - `tags` Tag[]
      - `tag` string, required
      - `color` string, required

## Response `200`

Returns the simulation run

## Other responses

- `400` — General error
- `404` — Simulation not found

---

[API](https://skmtc.net/amz-racing/apis/rosbag-bazaar-api.md) · [All operations](https://skmtc.net/amz-racing/apis/rosbag-bazaar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/amz-racing/rosbag-bazaar-api/revisions/9167cc5a1f11/schema)