---
title: "Cancel Evaluation"
method: POST
path: "/v1/evaluations/{evaluation_id}/cancel"
tags: ["Diamond", "evaluations"]
---

# Cancel Evaluation

`POST /v1/evaluations/{evaluation_id}/cancel`

Cancel a running evaluation (Kubernetes Job cancellation + workflow status update).

Cancels an evaluation that is in progress (CREATED, STARTING, or RUNNING status).
This will:
- Delete the Kubernetes Job (which cancels the running pod)
- Update workflow status to CANCELLED
- Optionally clean up partial S3 data (request file is kept for audit)

Args:
    evaluation_id: UUID of the evaluation to cancel
    claims: JWT claims with user and team info
    diamond_domain: Diamond domain orchestrator
    storage: Evaluation storage adapter

Returns:
    Status dict with "cancelled" status

Raises:
    HTTPException: 404 if evaluation not found, 400 if evaluation is already completed/cancelled

## Path parameters

- `evaluation_id` string, uuid, required

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/versions/a8b2ee2b2d06/schema)
