---
title: "Import Simulation Manifest"
method: POST
path: "/api/v1/admin/simulation-runs/imports"
tags: ["simulation archive administration"]
---

# Import Simulation Manifest

`POST /api/v1/admin/simulation-runs/imports`

## Request

- Base URL: `https://api.brumby.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brumby.com/api/v1/admin/simulation-runs/imports`
- Auth: HTTP bearer

## Request body

- SimulationRunManifest: Bounded, deterministic summary of one immutable ROS replay artifact.
  - `name` string, required
  - `scenario` string, nullable
  - `source_format` 'replay_jsonl' | 'rosbag2' | 'ros1_bag' | 'structured_ros_logs', required
  - `storage_host_device_id` string, nullable
  - `source_artifact_name` string, required
  - `artifact_sha256` string, required
  - `artifact_size_bytes` integer, required
  - `message_count` integer, required
  - `recorded_start_at` string, date-time, nullable
  - `recorded_end_at` string, date-time, nullable
  - `time_basis` 'source_clock' | 'relative_only', required
  - `importer_version` string, required
  - `topic_summary` SimulationTopicSummary[]
    - `topic` string, required
    - `message_count` integer, required
    - `first_observed_at` string, date-time, nullable
    - `last_observed_at` string, date-time, nullable
  - `source_metadata` object
  - `events` SimulationManifestEvent[]
    - `ordinal` integer, required
    - `source_topic` string, nullable
    - `event_kind` string, required
    - `source_observed_at` string, date-time, nullable
    - `source_offset_ns` integer, required
    - `summary` string, required
    - `severity` 'info' | 'warning' | 'error'
    - `payload` object

## Response `200`

Successful Response

- SimulationRunImportResponse
  - `created` boolean, required
  - `run` SimulationRunDetailResponse, required
    - `simulation_run_id` string, uuid, required
    - `name` string, required
    - `scenario` string, nullable, required
    - `source_format` 'replay_jsonl' | 'rosbag2' | 'ros1_bag' | 'structured_ros_logs', required
    - `storage_host_device_id` string, nullable, required
    - `source_artifact_name` string, required
    - `artifact_sha256` string, required
    - `artifact_size_bytes` integer, required
    - `manifest_sha256` string, required
    - `message_count` integer, required
    - `recorded_start_at` string, date-time, nullable, required
    - `recorded_end_at` string, date-time, nullable, required
    - `time_basis` 'source_clock' | 'relative_only', required
    - `imported_at` string, date-time, required
    - `imported_by_actor` string, required
    - `importer_version` string, required
    - `event_count` integer, required
    - `topic_summary` SimulationTopicSummary[], required
      - `topic` string, required
      - `message_count` integer, required
      - `first_observed_at` string, date-time, nullable
      - `last_observed_at` string, date-time, nullable
    - `replay_available` boolean, required
    - `replay_format` 'mcap', required
    - `replay_validation_status` 'ready' | 'ready_with_warnings' | 'invalid', required
    - `source_metadata` object, required
    - `events` SimulationRunEventResponse[], required
      - `event_id` string, uuid, required
      - `ordinal` integer, required
      - `source_topic` string, nullable, required
      - `event_kind` string, required
      - `source_observed_at` string, date-time, nullable, required
      - `source_offset_ns` integer, required
      - `summary` string, required
      - `severity` 'info' | 'warning' | 'error', required
      - `payload` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brumby/apis/brumby-platform-api.md) - [All operations](https://skmtc.dev/brumby/apis/brumby-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brumby/apis/brumby-platform-api/revisions/fe185e20813e?raw)