Skip to main content
DELETE
/
evaluations
/
{job_id}
{
  "job_id": "<string>",
  "status": "<string>",
  "deleted_at": {},
  "items_deleted": 123,
  "was_cancelled": true,
  "message": "<string>"
}

​
Overview

Deletes an evaluation job and all associated results. This action is irreversible and will permanently remove all evaluation data for the specified job. Jobs that are currently processing can be cancelled and deleted.

​
Headers

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

​
Path Parameters

​
job_id
string
required
Unique identifier of the evaluation job to delete

​
Query Parameters

​
force
boolean
default:"false"
Force deletion of processing jobs (cancels and deletes)

​
Response

​
job_id
string
required
ID of the deleted job
​
status
string
required
Final job status before deletion
​
deleted_at
datetime
required
Timestamp when the job was deleted
​
items_deleted
integer
required
Number of evaluation results deleted
​
was_cancelled
boolean
required
Whether the job was cancelled during deletion
​
message
string
required
Confirmation message

​
Examples

curl -X DELETE https://api.judge.example.com/evaluations/job_batch_456 \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.judge.example.com/evaluations/job_processing_789?force=true" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE https://api.judge.example.com/evaluations/invalid_job_id \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE https://api.judge.example.com/evaluations/job_processing_789 \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE https://api.judge.example.com/evaluations/job_other_org_123 \
  -H "X-API-Key: YOUR_API_KEY"