Skip to main content
POST
/
batches
{
  "batch_id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "total_evaluations": 123,
  "completed_evaluations": 123,
  "created_at": {}
}

​
Overview

Creates a batch job to evaluate multiple content items against one or more judges efficiently.

​
Request Body

​
name
string
required
Name for the batch job
​
description
string
Description of the batch job
​
judge_ids
array
required
Array of judge IDs to evaluate content against
​
content_ids
array
required
Array of content IDs to evaluate
​
priority
string
default:"normal"
Batch priority level
  • low - Lower priority processing
  • normal - Standard processing
  • high - Priority processing

​
Response

​
batch_id
string
required
Unique identifier for the batch
​
name
string
required
Batch name
​
status
string
required
Batch status
  • created - Batch created, not started
  • evaluating - Evaluations in progress
  • completed - All evaluations finished
  • failed - Batch failed
​
total_evaluations
integer
required
Total number of evaluations to be performed
​
completed_evaluations
integer
required
Number of completed evaluations
​
created_at
datetime
required
Creation timestamp

​
Examples

curl -X POST https://api.judge.example.com/batches \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q1 Content Review",
    "description": "Quarterly review of all blog content",
    "judge_ids": ["jdg_xyz789", "jdg_abc123"],
    "content_ids": ["cnt_001", "cnt_002", "cnt_003"],
    "priority": "normal"
  }'

curl -X POST https://api.judge.example.com/batches \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Test Batch",
    "judge_ids": ["invalid_judge"],
    "content_ids": ["cnt_001"]
  }'