Update Dataset

Overview

The update() method allows you to modify an existing dataset after it has been created.

Only name and metadata are mutable post-creation. All other fields (type, variants, strategies, uri, ground_truth_uri, data_catalog_uri, source_test_id, max_test_cases, etc.) are fixed for the lifetime of the dataset because they drive generation, credit accounting, and the stored test-case shape. Sending any of them in an update returns a 400.

Parameters

string

required

The ID of the dataset to update.

Deprecated alias: test_id.

string

New dataset name. Must be a non-empty string; leading and trailing whitespace are trimmed server-side.

Any

Arbitrary JSON-serializable metadata for tracking purposes. Replaces the existing metadata wholesale. Pass None to clear.

Returns

Returns the updated Dataset object.

Example

renamed = galtea.datasets.update(
    dataset_id=dataset.id,
    name=f"renamed-test-{run_identifier}",
)

Use Cases

Replacing Metadata

Overwrite the metadata object on an existing dataset:

with_new_metadata = galtea.datasets.update(
    dataset_id=dataset.id,
    metadata={"owner": "platform-team", "ticket": "QA-200", "priority": "high"},
)

Updating Name and Metadata Together

updated = galtea.datasets.update(
    dataset_id=dataset.id,
    name=f"final-test-{run_identifier}",
    metadata={"owner": "platform-team", "archived": True},
)

Notes

All fields except dataset_id default to PydanticUndefined (from pydantic_core). Omit a field (or pass PydanticUndefined) to leave it unchanged. Pass None to explicitly clear an optional field. Pass a value to update it.

Create Dataset - Create a new dataset
Get Dataset - Retrieve a dataset by ID
List Datasets - List datasets for a product
Delete Dataset - Soft-delete a dataset
Link Datasets - Attach an existing dataset to a specification
Unlink Datasets - Detach a dataset from a specification

Introduction

SDK

CLI

Concepts

Overview

Parameters

Returns

Example

Use Cases

Replacing Metadata

Updating Name and Metadata Together

Notes

​Overview

​Parameters

​Returns

​Example

​Use Cases

​Replacing Metadata

​Updating Name and Metadata Together

​Notes

​Related Methods

Overview

Parameters

Returns

Example

Use Cases

Replacing Metadata

Updating Name and Metadata Together

Notes

Related Methods