PUT/v2/gen-ai/evaluation_test_cases/{test_case_uuid}

Replace an evaluation test case

Replaces the configuration of an evaluation test case. Use the test_case_uuid path parameter to select the test case, and provide any configuration fields to update, such as its name, dataset, metrics, or star metric. A 200 response returns the test case UUID and its new version.

1 parameter · 6 body fields
test_case_uuidstringrequired
The UUID of the evaluation test case to update.

Evaluation test case configuration fields.

dataset_uuidstringoptional
Dataset against which the test‑case is executed.
descriptionstringoptional
Description of the test case.
metricsobjectoptional
Metric configuration containing the UUIDs of the metrics to use.
namestringoptional
Name of the test case.
star_metricobjectoptional
Star metric configuration, including the metric UUID, name, and success threshold or percentage threshold.
test_case_uuidstringoptional
Test-case UUID to update

6 status codes
200Returns an object containing the test case UUID and its new version number.
test_case_uuidstringoptional
versionintegeroptional
The new verson of the test case.
401Returned when authentication fails because the credentials are invalid.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
404Returned when the requested resource is not found.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
429Returned when the API rate limit has been exceeded.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
500Returned when a server error occurs.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
defaultThere was an unexpected error.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.

Error handling

A 401 is returned when authentication credentials are invalid, and a 404 is returned when the test case is not found. A 429 is returned when the API rate limit is exceeded, and a 500 indicates a server error. The test_case_uuid path parameter must identify the test case to update.