curl --request PATCH \
  --url https://api.arize.com/v2/tasks/{task_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "name": "Updated Task Name",
  "sampling_rate": 0.5,
  "query_filter": "metadata.environment = 'staging'"
}
EOF

{
  "id": "T25saW5lVGFzazo0NTpxUndY",
  "name": "Updated Task Name",
  "type": "template_evaluation",
  "project_id": "TW9kZWw6MTIzOmFCY0Q=",
  "dataset_id": null,
  "sampling_rate": 0.5,
  "is_continuous": true,
  "query_filter": "metadata.environment = 'staging'",
  "evaluators": [
    {
      "evaluator_id": "RXZhbHVhdG9yOjEyOmFCY0Q=",
      "evaluator_name": "Hallucination Eval",
      "query_filter": null,
      "column_mappings": {
        "input": "attributes.input.value",
        "output": "attributes.output.value"
      }
    }
  ],
  "experiment_ids": [],
  "last_run_at": "2026-03-01T14:30:00.000Z",
  "created_at": "2026-02-20T10:00:00.000Z",
  "updated_at": "2026-03-10T15:00:00.000Z",
  "created_by_user_id": "VXNlcjoxOm5OYkM="
}

Tasks

Update task

Update a task’s mutable fields. At least one field must be provided. Omitted fields are left unchanged.

Payload Requirements

At least one mutable field must be provided.
When evaluators is provided, the entire evaluator list is replaced.
sampling_rate and is_continuous are only applicable for project-based tasks.
Fields not valid for the task’s type return 400 (e.g. run_configuration on an evaluation task).
System-managed fields (id, type, created_at, updated_at) cannot be modified.

Valid example (update evaluation task)

{
  "name": "Updated Hallucination Check",
  "sampling_rate": 0.5,
  "query_filter": "metadata.environment = 'staging'"
}

Invalid example (no fields provided)

{}

This endpoint is in alpha, read more here.

PATCH

tasks

{task_id}

curl --request PATCH \
  --url https://api.arize.com/v2/tasks/{task_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "name": "Updated Task Name",
  "sampling_rate": 0.5,
  "query_filter": "metadata.environment = 'staging'"
}
EOF

{
  "id": "T25saW5lVGFzazo0NTpxUndY",
  "name": "Updated Task Name",
  "type": "template_evaluation",
  "project_id": "TW9kZWw6MTIzOmFCY0Q=",
  "dataset_id": null,
  "sampling_rate": 0.5,
  "is_continuous": true,
  "query_filter": "metadata.environment = 'staging'",
  "evaluators": [
    {
      "evaluator_id": "RXZhbHVhdG9yOjEyOmFCY0Q=",
      "evaluator_name": "Hallucination Eval",
      "query_filter": null,
      "column_mappings": {
        "input": "attributes.input.value",
        "output": "attributes.output.value"
      }
    }
  ],
  "experiment_ids": [],
  "last_run_at": "2026-03-01T14:30:00.000Z",
  "created_at": "2026-02-20T10:00:00.000Z",
  "updated_at": "2026-03-10T15:00: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

task_id

string

required

The unique task identifier (base64) A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

Body

application/json

PATCH body for PATCH /v2/tasks/{task_id}. The server derives the task type from the URL's task record and selects the appropriate schema; the body itself does not carry a type field.

Task type	Schema
`template_evaluation`	`UpdateEvaluationTaskRequest`
`code_evaluation`	`UpdateEvaluationTaskRequest`
`run_experiment`	`UpdateRunExperimentTaskRequest`

For template_evaluation and code_evaluation tasks, at least one of name, sampling_rate, is_continuous, query_filter, or evaluators must be provided.

For run_experiment tasks, at least one of name or run_configuration must be provided. When run_configuration is provided the stored config is atomically replaced.

Sending a field that is not valid for the resolved task type returns 400 (e.g. evaluators on a run_experiment task, or run_configuration on an evaluation task).

Option 1
Option 2

PATCH body for template_evaluation and code_evaluation tasks. The two types share the same updatable shape; the server derives the task type from the URL's task record. At least one field must be provided.

name

string

New task name.

Minimum string length: 1

sampling_rate

number

Sampling rate between 0 and 1. Only applicable for project-based tasks.

Required range: 0 <= x <= 1

is_continuous

boolean

Whether the task runs continuously. Only applicable for project-based tasks.

query_filter

string | null

Task-level query filter. Pass null to clear.

evaluators

object[]

Replaces the entire evaluator list. At least one evaluator is required when provided.

Minimum array length: 1

Show child attributes

Response

Returns the updated task

A task is a typed, configurable unit of work that ties one or more evaluators to a data source (project or dataset). run_experiment tasks additionally carry a run_configuration that defines the LLM or evaluator settings for each triggered run.

string

required

The unique identifier for the task

name

string

required

The name of the task

type

enum<string>

required

The task type.

template_evaluation - An LLM template-based evaluation task.
code_evaluation - A code-based evaluation task.
run_experiment - A task that runs experiments.

Available options:

template_evaluation,

code_evaluation,

run_experiment

is_continuous

boolean

required

Whether the task runs continuously on incoming data.

query_filter

string | null

required

Task-level query filter applied to all data.

evaluators

object[]

required

The evaluators attached to this task. Empty for run_experiment tasks.

Show child attributes

experiment_ids

string[]

required

Experiment identifiers (base64) for dataset-based tasks.

last_run_at

string<date-time> | null

required

When the task was last run.

created_at

string<date-time>

required

When the task was created.

updated_at

string<date-time>

required

When the task was last updated.

created_by_user_id

string | null

required

The unique identifier for the user who created the task.

project_id

string | null

The project identifier (base64). Present for project-based tasks.

dataset_id

string | null

The dataset identifier (base64). Present for dataset-based tasks.

sampling_rate

number | null

Sampling rate between 0 and 1. Only applicable for project-based tasks.

Required range: 0 <= x <= 1

run_configuration

object

The run configuration for a run_experiment task. Present only when type is run_experiment. Null for all other task types.

Option 1
Option 2

Show child attributes

Delete task List task runs

⌘I