Skip to Content
Judgment Labs

Submit a customer judge result

POST
/v1/projects/{projectId}/judge-results

Submit a customer score for one trace or session under any judge. Resubmitting for the same judge and target replaces its current customer score. Each submission, including a retry, writes a new result row. Hosted results are preserved. Validates against the production version and derives attribution from the target.

Authorization

apiKeyAuthorganizationHeader
headerAuthorizationBearer <token>

Your personal API key from Settings > Personal API Keys, sent as Bearer <key>.

headerX-Organization-Id<token>

The organization to act in. Copy it with Copy organization ID in the organization menu or the settings sidebar.

Path Parameters

projectId*string

Request Body

application/json
  1. body
target*|
value*boolean|number|string
reason?string
judge_id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

Response for status 200

application/json
  1. response
id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
Example Request
curl -X POST 'https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/judge-results' \  -H 'Content-Type: application/json' \  -d '{  "target": {    "type": "trace",    "trace_id": "string"  },  "value": true,  "judge_id": "968a8026-4d88-467b-937b-009ebfad94d9"}'
Example Response200
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"}