Skip to main content
POST
/
evaluations
/
single
{
  "evaluation_id": "<string>",
  "content_id": "<string>",
  "judge_id": "<string>",
  "status": "<string>",
  "overall_score": 123,
  "criteria_scores": [
    {
      "criterion_id": "<string>",
      "name": "<string>",
      "score": 123,
      "feedback": "<string>"
    }
  ],
  "summary": "<string>",
  "strengths": [
    {}
  ],
  "weaknesses": [
    {}
  ],
  "suggestions": [
    {}
  ],
  "evaluated_at": {}
}

​
Overview

Evaluates a single content item against a specified judge’s criteria. Returns evaluation scores, strengths, weaknesses, and suggestions. The evaluation is processed asynchronously.

​
Request Body

​
content_id
string
required
ID of the content to evaluate
​
judge_id
string
required
ID of the judge to use for evaluation
​
priority
string
default:"normal"
Evaluation priority
  • low - Lower priority processing
  • normal - Standard processing
  • high - Priority processing

​
Response

​
evaluation_id
string
required
Unique identifier for the evaluation
​
content_id
string
required
ID of the evaluated content
​
judge_id
string
required
ID of the judge used
​
status
string
required
Evaluation status
  • processing - Evaluation in progress
  • completed - Evaluation finished
  • failed - Evaluation failed
​
overall_score
number
Overall evaluation score (0-100)
​
criteria_scores
array
Individual criteria scores
​
summary
string
Overall evaluation summary
​
strengths
array
List of identified strengths
​
weaknesses
array
List of identified weaknesses
​
suggestions
array
List of improvement suggestions
​
evaluated_at
datetime
Timestamp when evaluation completed

​
Examples

curl -X POST https://api.judge.example.com/evaluations/single \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content_id": "cnt_abc123",
    "judge_id": "jdg_xyz789",
    "priority": "normal"
  }'

curl -X POST https://api.judge.example.com/evaluations/single \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content_id": "cnt_abc123",
    "judge_id": "invalid_judge"
  }'