---
title: "Start Batch Run"
method: POST
path: "/api/v1/eval_batch_runs"
tags: ["collections"]
---

# Start Batch Run

`POST /api/v1/eval_batch_runs`

Start a batch evaluation run on all files in the collection.

## Cookies

- `wos-session` string
- `datalab_active_team` string

## Request body

- StartBatchRunRequest
  - `collection_id` integer, required — ID of the collection to run against
  - `eval_rubric_id` integer, nullable — ID of the eval rubric to use. Required for standard pipelines, optional for custom pipelines (falls back to pipeline's eval_definition).
  - `pipeline_type` 'convert' | 'extract' | 'segment' — One of: convert, extract, segment
  - `pipeline_id` string, nullable — Optional custom pipeline ID
  - `page_schema` string, nullable — Required when pipeline_type=extract
  - `segmentation_schema` string, nullable — Required when pipeline_type=segment
  - `output_format` string, nullable — Comma-separated output formats (e.g. 'markdown,json,html')
  - `run_evals` boolean — Set false to process the collection through a pipeline WITHOUT scoring (e.g. S3 output writeback) — no rubric is required and none runs. Requires pipeline_id; incompatible with eval_rubric_id.

## Response `200`

Successful Response

- EvalBatchRunResponse
  - `id` integer, required
  - `collection_id` integer, required
  - `eval_rubric_id` integer, nullable, required
  - `pipeline_id` string, nullable, required
  - `pipeline_type` string, required
  - `status` string, required
  - `started_at` string, date-time, nullable, required
  - `completed_at` string, date-time, nullable, required
  - `total_files` integer, required
  - `completed_files` integer, required
  - `avg_score` number, nullable, required
  - `created` string, date-time, nullable, required
  - `eval_rubric_version` integer, nullable
  - `eval_definition_snapshot` object, nullable
  - `pipeline_version` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/datalab/apis/datalab-api.md) · [All operations](https://skmtc.net/datalab/apis/datalab-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datalab/datalab-api/versions/aa9f8ee18efb/schema)