> ## 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, queued, or running eval run.

Cancels an eval run in the `PENDING`, `QUEUED`, or `RUNNING` status. Runs in a terminal status return a `409` error.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**run\_id** `string` *required*

The ID of the eval run to cancel. The run must be in the `PENDING`, `QUEUED`, or `RUNNING` status.

### Response

**id** `string`

Unique identifier for the eval run.

**org\_id** `string`

The organization that owns this run.

**status** `string`

Updated status of the run. Will be `CANCELLED`.

**triggered\_by** `string`

How the run was triggered. One of `manual`, `auto`, `backfill`.

**run\_mode** `string`

The scoring modality. One of `text`, `audio`, `full`.

**submitted\_call\_ids** `array of string`

The call IDs that were submitted for scoring.

**submitted\_attached\_agents** `array of objects`

The agent attachments submitted with the run.

**workbench\_setup\_id** `string or null`

The associated workbench setup, if any.

**workbench\_setup\_version\_id** `string or null`

The pinned workbench setup version, if any.

**resolved\_call\_count** `integer`

Number of calls resolved for the run.

**resolved\_agent\_count** `integer`

Number of eval agents resolved for the run.

**resolved\_atom\_count** `integer`

Total call-by-agent evaluations in the run.

**completed\_atom\_count** `integer`

Number of evaluations completed before cancellation.

**summary** `object or null`

Partial scoring summary if any atoms completed before cancellation, otherwise `null`.

**billable\_cost\_usd** `number or null`

Billable cost for evaluations completed before cancellation, or `null` if not yet finalized.

**error\_code** `string or null`

Error code if applicable, otherwise `null`.

**error\_message** `string or null`

Human-readable error message if applicable, otherwise `null`.

**workflow\_id** `string or null`

Internal workflow identifier, if applicable.

**metadata** `object`

Key-value metadata attached to the run.

**created\_at** `string`

ISO 8601 timestamp when the run was created.

**started\_at** `string or null`

ISO 8601 timestamp when the run started, or `null` if it never started.

**completed\_at** `string or null`

ISO 8601 timestamp when the run was cancelled.

```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
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.