---
title: "Import Test Run"
method: POST
path: "/api/v1/admin/test-runs"
tags: ["engineering test administration"]
---

# Import Test Run

`POST /api/v1/admin/test-runs`

## 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/test-runs`
- Auth: HTTP bearer

## Request body

- EngineeringTestRunManifestV1: Bounded, completed run uploaded atomically by the suite wrapper.
  - `schema_version` '1', required
  - `run_id` string, uuid4, required
  - `manifest_sha256` string, required
  - `suite` 'teensy_host', required
  - `device_id` string, nullable
  - `status` 'passed' | 'failed' | 'error', required: Terminal status of one completed engineering-suite execution.
  - `started_at` string, date-time, required
  - `finished_at` string, date-time, required
  - `catalogue_version` integer, required
  - `catalogue_sha256` string, required
  - `source` EngineeringTestSourceV1, required
    - `repository` string, required
    - `commit_sha` string, required
    - `tree_sha` string, required
    - `branch` string, nullable
    - `dirty` boolean, required
  - `runner` EngineeringTestRunnerV1, required
    - `hostname` string, required
    - `platform` string, required
    - `architecture` string, required
    - `python_version` string, required
    - `producer_version` string, required
  - `command` string[], required
  - `exit_code` integer, nullable
  - `counts` EngineeringTestCountsV1, required
    - `total` integer, required
    - `passed` integer, required
    - `failed` integer, required
    - `skipped` integer, required
    - `error` integer, required
    - `not_run` integer, required
    - `checks` integer, required
    - `failures` integer, required
  - `raw_output` EngineeringSuiteOutputV1, required
    - `encoding` 'utf-8', required
    - `truncated` boolean, required
    - `bytes_total` integer, required
    - `sha256` string, required
    - `text` string, required
  - `scenarios` EngineeringTestScenarioResultV1[], required
    - `scenario_id` string, required
    - `platform` string, required
    - `domain` string, required
    - `component` string, required
    - `mechanism` string, required
    - `kind` string, required
    - `title` string, required
    - `test_ref` string, required
    - `status` 'passed' | 'failed' | 'skipped' | 'error' | 'not_run', required: Terminal or explicitly unexecuted status of one catalogue scenario.
    - `duration_ms` integer, nullable
    - `log` EngineeringScenarioLogV1, required
      - `encoding` 'utf-8', required
      - `truncated` boolean, required
      - `bytes_total` integer, required
      - `sha256` string, required
      - `text` string, required

## Response `200`

Successful Response

- EngineeringTestRunImportResponse
  - `created` boolean, required
  - `run` EngineeringTestRunDetailResponse, required
    - `run_id` string, uuid, required
    - `schema_version` '1', required
    - `suite` string, required
    - `device_id` string, nullable, required
    - `status` 'passed' | 'failed' | 'error', required: Terminal status of one completed engineering-suite execution.
    - `started_at` string, date-time, required
    - `finished_at` string, date-time, required
    - `duration_ms` integer, required
    - `imported_at` string, date-time, required
    - `imported_by_actor` string, required
    - `manifest_sha256` string, required
    - `catalogue_version` integer, required
    - `catalogue_sha256` string, required
    - `source` EngineeringTestSourceV1, required
      - `repository` string, required
      - `commit_sha` string, required
      - `tree_sha` string, required
      - `branch` string, nullable
      - `dirty` boolean, required
    - `runner` EngineeringTestRunnerV1, required
      - `hostname` string, required
      - `platform` string, required
      - `architecture` string, required
      - `python_version` string, required
      - `producer_version` string, required
    - `command` string[], required
    - `exit_code` integer, nullable, required
    - `counts` EngineeringTestCountsV1, required
      - `total` integer, required
      - `passed` integer, required
      - `failed` integer, required
      - `skipped` integer, required
      - `error` integer, required
      - `not_run` integer, required
      - `checks` integer, required
      - `failures` integer, required
    - `scenario_count` integer, required
    - `raw_output` EngineeringSuiteOutputV1, required
      - `encoding` 'utf-8', required
      - `truncated` boolean, required
      - `bytes_total` integer, required
      - `sha256` string, required
      - `text` string, 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)