---
title: "Single view surface for all LiveKit sim ingestion HTTP endpoints."
method: POST
path: "/simulate/api/alk-simulate/run-tests/{run_test_id}/test-executions/"
tags: ["simulate"]
---

# Single view surface for all LiveKit sim ingestion HTTP endpoints.

`POST /simulate/api/alk-simulate/run-tests/{run_test_id}/test-executions/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/simulate/api/alk-simulate/run-tests/{run_test_id}/test-executions/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Views here are intentionally minimal: they resolve the tenant-scoped
target row, hand the parsed payload to
`simulate.services.alk_simulate_ingestion`, and format the response.

## Request body

- ALKSimulateStartTestExecutionRequest
  - `scenario_ids` string[]
  - `scenario_selectors` object[]
  - `simulator_agent_id` string, uuid, nullable
  - `harness_job_id` string, uuid, nullable

## Response `200`

OK

- ALKSimulateStartTestExecutionResponse
  - `status` boolean
  - `result` ALKSimulateStartTestExecutionResult, required
    - `test_execution_id` string, uuid, required
    - `run_test_id` string, uuid, required
    - `scenario_ids` string[], required
    - `total_scenarios` integer, required
    - `status` string, required

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `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)