Movatterモバイル変換

[0]ホーム
URL:

Skip to main content
Optimization
Evaluations
  • Overview
API Reference

API Reference: Datasets & Datapoints

API reference for endpoints that manage datasets and datapoints.

In TensorZero, datasets are collections of data that can be used for workflows like evaluations and optimization recipes.You can create and manage datasets using the TensorZero UI or programmatically using the TensorZero Gateway.A dataset is a named collection of datapoints.Each datapoint belongs to a function, with fields that depend on the function’s type.Broadly speaking, each datapoint largely mirrors the structure of an inference, with an input, an optional output, and other associated metadata (e.g. tags).
You can find a complete runnable example of how to use the datasets and datapoints API in ourGitHub repository.

Endpoints & Methods

List datapoints in a dataset

This endpoint returns a list of datapoints in the dataset.Each datapoint is an object that includes all the relevant fields (e.g. input, output, tags).
  • Gateway Endpoint:GET /datasets/{dataset_name}/datapoints
  • Client Method:list_datapoints
  • Parameters:
    • dataset_name (string)
    • function (string, optional)
    • limit (int, optional, defaults to 100)
    • offset (int, optional, defaults to 0)
Iffunction is set, this method only returns datapoints in the dataset for the specified function.

Get a datapoint

This endpoint returns the datapoint with the given ID, including all the relevant fields (e.g. input, output, tags).
  • Gateway Endpoint:GET /datasets/{dataset_name}/datapoints/{datapoint_id}
  • Client Method:get_datapoint
  • Parameters:
    • dataset_name (string)
    • datapoint_id (string)

Add datapoints to a dataset (or create a dataset)

This endpoint adds a list of datapoints to a dataset.If the dataset does not exist, it will be created with the given name.
  • Gateway Endpoint:POST /datasets/{dataset_name}/datapoints
  • Client Method:create_datapoints
  • Parameters:
    • dataset_name (string)
    • datapoints (list of objects, see below)
Forchat functions, each datapoint object must have the following fields:
  • function_name (string)
  • input (object, identical to an inference’sinput)
  • output (a list of objects, optional, each object must be a content block like in an inference’s output)
  • allowed_tools (list of strings, optional, identical to an inference’sallowed_tools)
  • tool_choice (string, optional, identical to an inference’stool_choice)
  • parallel_tool_calls (boolean, optional, defaults tofalse)
  • tags (map of string to string, optional)
  • name (string, optional)
Forjson functions, each datapoint object must have the following fields:
  • function_name (string)
  • input (object, identical to an inference’sinput)
  • output (object, optional, an object that matches theoutput_schema of the function)
  • output_schema (object, optional, a dynamic JSON schema that overrides the output schema of the function)
  • tags (map of string to string, optional)
  • name (string, optional)

Update datapoints in a dataset

This endpoint updates one or more datapoints in a dataset by creating new versions.The original datapoint is marked as stale (i.e. a soft deletion), and a new datapoint is created with the updated values and a new ID.The response returns the newly created IDs.
  • Gateway Endpoint:PATCH /v1/datasets/{dataset_name}/datapoints
  • Client Method:update_datapoints
Each object must have the fieldsid (string, UUIDv7) andtype ("chat" or"json").The following fields are optional.If provided, they will update the corresponding fields in the datapoint.If omitted, the fields will remain unchanged.If set tonull, the fields will be cleared (as long as they are nullable).Forchat functions, you can update the following fields:
  • input (object) - replaces the datapoint’s input
  • output (list of content blocks) - replaces the datapoint’s output
  • tool_params (object or null) - replaces the tool configuration (can be set tonull to clear)
  • tags (map of string to string) - replaces all tags
  • metadata (object) - updates metadata fields:
    • name (string or null) - replaces the name (can be set tonull to clear)
Forjson functions, you can update the following fields:
  • input (object) - replaces the datapoint’s input
  • output (object or null) - replaces the output (validated against the output schema; can be set tonull to clear)
  • output_schema (object) - replaces the output schema
  • tags (map of string to string) - replaces all tags
  • metadata (object) - updates metadata fields:
    • name (string or null) - replaces the name (can be set tonull to clear)
If you’re only updating datapoint metadata (e.g.name), theupdate_datapoint_metadata method below is an alternative that does not affect the datapoint ID.
The endpoint returns an object withids, a list of IDs (strings, UUIDv7) of the updated datapoints.

Update datapoint metadata

This endpoint updates metadata fields for one or more datapoints in a dataset.Unlike updating the full datapoint, this operation updates the datapoint in-place without creating a new version.
  • Gateway Endpoint:PATCH /v1/datasets/{dataset_name}/datapoints/metadata
  • Client Method:update_datapoints_metadata
  • Parameters:
    • dataset_name (string)
    • datapoints (list of objects, see below)
Thedatapoints field must contain a list of objects.Each object must have the fieldid (string, UUIDv7).The following field is optional:
  • metadata (object) - updates metadata fields:
    • name (string or null) - replaces the name (can be set tonull to clear)
If themetadata field is omitted ornull, no changes will be made to the datapoint.The endpoint returns an object withids, a list of IDs (strings, UUIDv7) of the updated datapoints.These IDs are the same as the input IDs since the datapoints are updated in-place.

Delete a datapoint

This endpoint performs asoft deletion: the datapoint is marked as stale and will be disregarded by the system in the future (e.g. when listing datapoints or running evaluations), but the data remains in the database.
  • Gateway Endpoint:DELETE /datasets/{dataset_name}/datapoints/{datapoint_id}
  • Client Method:delete_datapoint
  • Parameters:
    • dataset_name (string)
    • datapoint_id (string)
⌘I
[8]ページ先頭
©2009-2025 Movatter.jp