---
title: "Queue Http Simulation Run"
method: POST
path: "/v1/queue-http-text-simulation-run"
tags: ["HTTP Text Agent"]
---

# Queue Http Simulation Run

`POST /v1/queue-http-text-simulation-run`

Queue a new simulation run and test results for HTTP text agent.
Takes simulation_id, optional prompt_id, knowledge_base_id, and digital_human_ids.
If digital_human_ids is not provided, uses all digital humans for the simulation.
Returns simulation_run_id (experiment_run_id) and simulation_result_ids (array of test result IDs).

## Headers

- `X-API-Key` string, required

## Request body

- HttpSimulationRunRequest — Request model for HTTP simulation run
  - `simulation_id` string, required — ID of the simulation to be run
  - `prompt_id` string, nullable — Prompt UUID associated with this run
  - `knowledge_base_id` string, nullable — Deprecated and ignored for grounding (the worker resolves KB from the documents model). Kept as a loose optional pass-through so existing API integrations that still send it keep working.
  - `digital_human_ids` string[], nullable — Digital human IDs to be used in the simulation
  - `runs_per_digital_human` integer, nullable — Optional per-run override for how many test_results to spawn per selected digital human. Falls back to 1 when omitted.

## Response `200`

Successful Response

- HttpSimulationRunResponse — Response model for HTTP simulation run
  - `simulation_run_id` string, required — ID of the created simulation run (experiment_run)
  - `simulation_result_ids` string[], required — IDs of the created simulation results (test results)
  - `agent_id` string, required — ID of the agent associated with the simulation run
  - `status` string — Status of the response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/f48cef80963f/schema)