> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Eval Run

> Cancel a pending or running eval run.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="run_id" type="string" required>
  The ID of the eval run to cancel.
</ParamField>

### Response

<ResponseField name="id" type="string">
  Unique identifier for the eval run.
</ResponseField>

<ResponseField name="org_id" type="string">
  The organization that owns this run.
</ResponseField>

<ResponseField name="status" type="string">
  Updated status of the run. Will be `CANCELLED`.
</ResponseField>

<ResponseField name="triggered_by" type="string">
  How the run was triggered. One of `manual`, `auto`, `backfill`.
</ResponseField>

<ResponseField name="run_mode" type="string">
  The scoring modality. One of `text`, `audio`, `full`.
</ResponseField>

<ResponseField name="submitted_call_ids" type="array of string">
  The call IDs that were submitted for scoring.
</ResponseField>

<ResponseField name="submitted_attached_agents" type="array of objects">
  The agent attachments submitted with the run.
</ResponseField>

<ResponseField name="workbench_setup_id" type="string or null">
  The associated workbench setup, if any.
</ResponseField>

<ResponseField name="workbench_setup_version_id" type="string or null">
  The pinned workbench setup version, if any.
</ResponseField>

<ResponseField name="resolved_call_count" type="integer">
  Number of calls resolved for the run.
</ResponseField>

<ResponseField name="resolved_agent_count" type="integer">
  Number of eval agents resolved for the run.
</ResponseField>

<ResponseField name="resolved_atom_count" type="integer">
  Total call-by-agent evaluations in the run.
</ResponseField>

<ResponseField name="completed_atom_count" type="integer">
  Number of evaluations completed before cancellation.
</ResponseField>

<ResponseField name="summary" type="object or null">
  Partial scoring summary if any atoms completed before cancellation, otherwise `null`.
</ResponseField>

<ResponseField name="billable_cost_usd" type="number or null">
  Billable cost for evaluations completed before cancellation, or `null` if not yet finalized.
</ResponseField>

<ResponseField name="error_code" type="string or null">
  Error code if applicable, otherwise `null`.
</ResponseField>

<ResponseField name="error_message" type="string or null">
  Human-readable error message if applicable, otherwise `null`.
</ResponseField>

<ResponseField name="workflow_id" type="string or null">
  Internal workflow identifier, if applicable.
</ResponseField>

<ResponseField name="metadata" type="object">
  Key-value metadata attached to the run.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp when the run was created.
</ResponseField>

<ResponseField name="started_at" type="string or null">
  ISO 8601 timestamp when the run started, or `null` if it never started.
</ResponseField>

<ResponseField name="completed_at" type="string or null">
  ISO 8601 timestamp when the run was cancelled.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
      "org_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
      "status": "CANCELLED",
      "triggered_by": "manual",
      "run_mode": "text",
      "submitted_call_ids": [
        "a1b2c3d4-0000-0000-0000-000000000001",
        "a1b2c3d4-0000-0000-0000-000000000002",
        "a1b2c3d4-0000-0000-0000-000000000003"
      ],
      "submitted_attached_agents": [
        {
          "eval_agent_id": "11111111-aaaa-bbbb-cccc-dddddddddddd",
          "eval_agent_version_id": "22222222-aaaa-bbbb-cccc-dddddddddddd",
          "weight": 100,
          "target_level_keys": ["pass"]
        }
      ],
      "workbench_setup_id": null,
      "workbench_setup_version_id": null,
      "resolved_call_count": 3,
      "resolved_agent_count": 1,
      "resolved_atom_count": 3,
      "completed_atom_count": 1,
      "summary": null,
      "billable_cost_usd": 0.01,
      "error_code": null,
      "error_message": null,
      "workflow_id": null,
      "metadata": {},
      "created_at": "2026-05-27T10:00:00.000Z",
      "started_at": "2026-05-27T10:00:05.000Z",
      "completed_at": "2026-05-27T10:00:38.000Z"
    },
    "errors": null
  }
  ```
</ResponseExample>