---
title: "Provider-neutral control plane for hosted ALK harness jobs."
method: POST
path: "/simulate/api/harness-jobs/{id}/runs/"
tags: ["simulate"]
---

# Provider-neutral control plane for hosted ALK harness jobs.

`POST /simulate/api/harness-jobs/{id}/runs/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/simulate/api/harness-jobs/{id}/runs/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Validates the v1.6 request contract and delegates execution to the public backend selected by
``settings.HARNESS_PROVIDER`` (``hosted`` or ``sandbox``). The hosted backend independently
selects its managed sandbox runtime.

## Request body

- HarnessRunCreate
  - `scenario_ids` string[], required
  - `trials` integer

## Response `202`

Accepted

- HarnessRunCreateResponse
  - `environment_id` string, uuid, required
  - `job_id` string, uuid, required
  - `run_id` string, uuid, required
  - `run_test_id` string, uuid, required
  - `test_execution_id` string, uuid, required
  - `scenario_count` integer, required
  - `trials` integer, required
  - `total_calls` integer, required
  - `state` string, required
  - `stage` string, required

## Other responses

- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)