Skip to main content

Cancel a queued job

POST /v1/jobs/{job_id}/cancel

Cancel a queued job

Credential. An API key (jean_live_…) or a dashboard session token.

curl --fail-with-body -X POST "https://api-833252724876.us-central1.run.app/v1/jobs/job_q1w2e3r4t5y6u7i8o9p0/cancel" \
-H "Authorization: Bearer $JEAN_API_KEY"

Path

NameTypeRequiredNotes
job_idstringyes

Response · 200

{
"attempts": 1,
"created_at": "2026-01-15T09:30:00Z",
"finished_at": "2026-01-15T09:30:18Z",
"id": "job_q1w2e3r4t5y6u7i8o9p0",
"label": "nightly",
"org_id": "org_k3j2h4g5f6d7s8a9q0w1",
"request_id": "req_z9x8c7v6b5n4m3l2",
"result": {
"hfm_sha": "9f2c1ab4d7e0",
"metric": "accuracy",
"n": 200,
"n_submitted": 200,
"n_unmatched": 0,
"suite_id": "suite:smoke-v1",
"suite_version": "1",
"value": 0.734
},
"started_at": "2026-01-15T09:30:02Z",
"status": "succeeded",
"trace_url": "https://storage.googleapis.com/jean-artifacts/.../trace.json",
"type": "eval",
"versions": {
"hfm_sha": "9f2c1ab4d7e0",
"suite_id": "suite:smoke-v1",
"suite_version": "1"
}
}

Errors

StatusMeaning
401Unauthenticated, invalid token or revoked key.
403Forbidden, session required or org required.
404No such resource in this org.
409The job is not in a cancellable state.
422Validation failed.
429Quota or rate limit exceeded; error.details says which, and when.
500Internal error; quote error.request_id when reporting it.

Every one carries the same envelope.

API overview · Full contract