HTTP Text Agent

Queue Http Simulation Run

Changed on

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).

post/v1/queue-http-text-simulation-run

Request

  • Base URL
    https://api.getbluejay.ai
  • URL
    https://api.getbluejay.ai/v1/queue-http-text-simulation-run
  • Auth
    HTTPBearer (a scheme the document does not define)

Headers

X-Organization-Idstring
X-API-Keystring required

API key required to authenticate requests.

Request body

simulation_idstring required

ID of the simulation to be run

prompt_idstring nullable

Deprecated. Use agent_version_id. Same uuid, still works.

agent_version_idstring nullable

Agent version UUID associated with this run

knowledge_base_idstring 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_idsstring[] nullable

Digital human IDs to be used in the simulation

runs_per_digital_humaninteger nullable

Optional per-run override for how many conversations to spawn per selected digital human. Falls back to 1 when omitted.

Response

Successful Response

simulation_run_idstring required

ID of the created simulation run (experiment_run)

simulation_result_idsstring[] required

IDs of the created simulation results (test results)

agent_idstring required

ID of the agent associated with the simulation run

statusstring

Status of the response

Changes