Sign in
Tasks

Get task

Returns a single task by its ID.

<Note>This endpoint is in beta, read more here.</Note>

get/v2/tasks/{task_id}

Path parameters

task_idstring required

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

Example:RW50aXR5OjEyMzQ1

The unique task identifier (base64)

Response

Returns a single task object

idstring required

The unique identifier for the task

namestring required

The name of the task

type'TEMPLATE_EVALUATION' | 'CODE_EVALUATION' | 'RUN_EXPERIMENT' 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.
project_idstring nullable

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

dataset_idstring nullable

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

sampling_ratenumber nullable

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

is_continuousboolean required

Whether the task runs continuously on incoming data.

query_filterstring nullable required

Task-level query filter applied to all data. Span-granularity shape only. Null when the task uses the trace/session shape (query_filters). Mutually exclusive with query_filters.

experiment_idsstring[] required

Experiment identifiers (base64) for dataset-based tasks.

last_run_atstring date-time nullable required

When the task was last run.

created_atstring date-time required

When the task was created.

updated_atstring date-time required

When the task was last updated.

created_by_user_idstring nullable required

The unique identifier for the user who created the task.

Changes

Changed in 2 of the 16 revisions of this API.4

  • f63ac334fd4a2See the full diff
    • ○

      added the optional property evaluators/items/query_mappings to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property query_filters to the response with the 200 status

      response-optional-property-added

  • 9263b98aaefb2See the full diff
    • ○

      added the optional property run_configuration/allOf[RunConfiguration]/oneOf[LlmGenerationRunConfig]/invocation_parameters/service_tier to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property run_configuration/allOf[RunConfiguration]/oneOf[TemplateEvaluationRunConfig]/invocation_parameters/service_tier to the response with the 200 status

      response-optional-property-added

Of the 16 revisions, 1 has no diff computed.