---
title: "Run a batch of scripted-persona Simulations to completion"
method: POST
path: "/v1/agents/{agent_id}/workflow/simulations"
---

# Run a batch of scripted-persona Simulations to completion

`POST /v1/agents/{agent_id}/workflow/simulations`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/agents/{agent_id}/workflow/simulations`
- Auth: none declared

Drives up to 20 named scenarios end-to-end synchronously (no network I/O -- scripted personas only) and reports a pass rate against each scenario's declared expected outcome. One broken scenario is reported as its own error entry rather than aborting the batch.

## Path parameters

- `agent_id` string, required

## Request body

- object
  - `pinned_source` 'draft' | 'published'
  - `scenario_ids` string[], required

## Response `200`

Batch pass/fail summary and per-scenario results

## Other responses

- `400`: Empty or oversized scenario_ids list

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/95b8c66f99aa?raw)