---
title: "Run Preview Batch"
method: POST
path: "/api/simulator/preview-batch"
tags: ["simulator"]
---

# Run Preview Batch

`POST /api/simulator/preview-batch`

## Request

- Base URL: `https://www.gateco.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://www.gateco.ai/api/simulator/preview-batch`
- Auth: OAuth 2 (password, token URL `/api/auth/login`)

Execute a live search once and evaluate policies per principal.

Runs the search a single time across the connector, then fans out policy
evaluation for up to 5 principals in parallel. Returns a list envelope:
``{"data": [PreviewResponse, ...]}``.

Readiness guards and audit behaviour are identical to ``/preview``.

## Request body

- BatchPreviewRequest: Request body for the batch live preview endpoint.
  - `principal_ids` string[], required
  - `connector_id` string, required
  - `query` string, required
  - `top_k` integer
  - `search_mode` 'vector' | 'keyword' | 'hybrid'
  - `alpha` number, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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