Skip to main content

Scenario packs

Run a frozen scenario pack against an agent and read the verdict.

MethodPathScopeSummary
POST/test/runreviewRun Scenario
GET/test/scenariosreviewList Scenarios

Try it

curl -sf -H "Authorization: Bearer $VIGIL_KEY" "$VIGIL_URL/test/scenarios" # review key

Routes

POST /test/run

Run Scenario. Scope: review.

Request body:

{
"agent_id": "string",
"scenario_id": "string",
"dti": 0
}
FieldTypeRequiredNotes
agent_idstringyes
scenario_idstringyes
dtinumber | nullno

Response 200:

{
"agent_id": "string",
"scenario_id": "string",
"scenario_name": "string",
"domain": "string",
"risk": "string",
"steps": [
{
"step": 0,
"label": "string",
"event_type": "string",
"bii": 0,
"gate_status": "string",
"reason": "string",
"requires_human_review": true
}
],
"final_bii": 0,
"final_gate": "string",
"composite_trust": 0,
"min_bii": 0,
"max_bii": 0,
"collapse_count": 0,
"alert_count": 0,
"hold_count": 0,
"pass_count": 0,
"verdict": "string"
}

GET /test/scenarios

List Scenarios. Scope: review.

Response 200:

"any"

Generated from openapi.json (VIGIL 0.2.0). Scopes follow the router dependencies in VIGIL_SPEC.md section 4.2.