Skip to main content
POST
/
v2
/
task-runs
/
{run_id}
/
cancel
Cancel task run
curl --request POST \
  --url https://api.arize.com/v2/task-runs/{run_id}/cancel \
  --header 'Authorization: Bearer <token>'
{
  "id": "VGFza1J1bjo5OTpxUndY",
  "task_id": "T25saW5lVGFzazo0NTpxUndY",
  "status": "completed",
  "run_started_at": "2026-03-07T10:30:01.000Z",
  "run_finished_at": "2026-03-07T10:35:22.000Z",
  "data_start_time": "2026-03-01T00:00:00.000Z",
  "data_end_time": "2026-03-07T00:00:00.000Z",
  "num_successes": 4850,
  "num_errors": 12,
  "num_skipped": 138,
  "created_at": "2026-03-07T10:30:00.000Z",
  "created_by_user_id": "VXNlcjoxOm5OYkM="
}

Authorizations

​
Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Path Parameters

​
run_id
string
required

The task run global ID (base64) A universally unique identifier

Example:

"RW50aXR5OjEyMzQ1"

Response

Returns a single task run object

A task run is an async job that executes the work defined on a task.

​
id
string
required

The unique identifier for the task run.

​
task_id
string
required

The parent task global ID (base64).

​
status
enum<string>
required

The current status of the run.

Available options:
pending,
running,
completed,
failed,
cancelled
​
run_started_at
string<date-time> | null
required

When the run started processing.

​
run_finished_at
string<date-time> | null
required

When the run finished processing.

​
data_start_time
string<date-time> | null
required

Start of the data window evaluated.

​
data_end_time
string<date-time> | null
required

End of the data window evaluated.

​
num_successes
integer
required

Number of successfully evaluated items.

​
num_errors
integer
required

Number of items that errored during evaluation.

​
num_skipped
integer
required

Number of items that were skipped.

​
created_at
string<date-time>
required

When the run was created.

​
created_by_user_id
string | null
required

The unique identifier for the user who triggered the run.