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 unique task run identifier (base64) A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

Response

Returns a single task run object

A task run is an async job that executes the work defined on a task. Runs are created by triggering an existing task (POST /v2/tasks/{task_id}/trigger). For run_experiment tasks, experiment_id is populated after the experiment is provisioned; poll GET /v2/task-runs/{run_id} until status reaches a terminal state.

​
id
string
required

The unique identifier for the task run.

​
task_id
string
required

The parent task identifier (base64).

​
status
enum<string>
required

Status of a task run.

  • pending - The run has been created but not yet started.
  • running - The run is currently in progress.
  • completed - The run finished successfully.
  • failed - The run encountered an error and stopped.
  • cancelled - The run was cancelled before completion.
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. Null for run_experiment runs.

​
data_end_time
string<date-time> | null
required

End of the data window evaluated. Null for run_experiment runs.

​
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.

​
experiment_id
string | null

Created experiment identifier (base64). Present only for run_experiment task runs; null for all other task types.