Cancel Evaluation

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

POST

evaluations

{evaluation_id}

cancel

Cancel Evaluation

curl --request POST \
  --url https://api.example.com/v1/evaluations/{evaluation_id}/cancel

{}

Path Parameters

evaluation_id

string<uuid>

required

Response

Successful Response

{key}

string

Last modified on April 21, 2026

Generate Report On DemandGenerate a trust report on demand (Layer 3). This endpoint triggers LLM analysis + HTML/PDF report generation for a completed evaluation. Reports are cached in S3 — subsequent calls return the cached version unless force_regenerate=True. Reports are NOT auto-generated on evaluation completion (CON-256). Users explicitly request reports when they need proof of compliance or want a printable summary.

⌘I

Cancel Evaluation

curl --request POST \
  --url https://api.example.com/v1/evaluations/{evaluation_id}/cancel

{}