Skip to main content
POST
/
api-key
/
judges
{
  "judge_id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "created_at": {}
}

​
Overview

Creates a new judge using API key authentication for programmatic access. This endpoint provides the same functionality as the user-authenticated judge creation but uses organization API keys.

​
Headers

​
X-API-Key
string
required
Organization API key for authentication

​
Request Body

​
name
string
required
Name of the judge
​
description
string
required
Detailed description of what this judge evaluates
​
content_type
string
required
Type of content this judge evaluates (text, video, audio, image)
​
criteria
array
required
List of evaluation criteria

​
Response

​
judge_id
string
required
Unique identifier for the created judge
​
name
string
required
Judge name
​
status
string
required
Judge status (ready, learning, training)
​
created_at
datetime
required
Creation timestamp

​
Examples

curl -X POST https://api.judge.example.com/api-key/judges \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "API Content Judge",
    "description": "Evaluates content quality via API",
    "content_type": "text",
    "criteria": [
      {
        "name": "Quality",
        "description": "Overall content quality"
      }
    ]
  }'