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

import requests

url = "https://api.example.com/v1/evaluations/{evaluation_id}/cancel"

response = requests.post(url)

print(response.text)

const options = {method: 'POST'};

fetch('https://api.example.com/v1/evaluations/{evaluation_id}/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/evaluations/{evaluation_id}/cancel"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

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

import requests

url = "https://api.example.com/v1/evaluations/{evaluation_id}/cancel"

response = requests.post(url)

print(response.text)

const options = {method: 'POST'};

fetch('https://api.example.com/v1/evaluations/{evaluation_id}/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/evaluations/{evaluation_id}/cancel"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Get Started

Evaluate Agents

Protect Agents

Reference

Cancel Evaluation

Path Parameters

Response