---
title: "Batch Run Live Prompt Version"
method: POST
path: "/v1/projects/{projectID}/prompts/{slug}/batch-run"
tags: ["Prompt Runs"]
---

# Batch Run Live Prompt Version

`POST /v1/projects/{projectID}/prompts/{slug}/batch-run`

Renders the active 'live' template version and executes it concurrently against multiple variable payloads.

## Path parameters

- `projectID` string, uuid, required
- `slug` string, required

## Request body

- BatchRunRequest
  - `batch` object[], required
    - `variables` object
  - `model` string, nullable
  - `model_params` object, nullable

## Response `200`

Correlated list of model completions

- BatchRunResponse
  - `results` object[], required
    - `response` string
    - `error` string
  - `model` string, required
  - `version` integer, required
  - `slug` string, required

## Other responses

- `400` — Missing keys or invalid parameters
- `401` — Unauthorized
- `404` — Prompt or version not found

---

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