DigitalOcean API (unofficial showcase)
GET/v2/gen-ai/model_evaluation_runs

List Model Evaluation Runs

To list model evaluation runs, send a GET request to /v2/genai/model_evaluation_runs.

9 parameters
eval_preset_uuidstringoptional
UUID of the evaluation preset to filter by.
statusstringoptional
Filter by evaluation run status.
Allowed:MODEL_EVALUATION_RUN_STATUS_UNSPECIFIEDMODEL_EVALUATION_RUN_QUEUEDMODEL_EVALUATION_RUN_RUNNING_DATASETMODEL_EVALUATION_RUN_EVALUATING_RESULTSMODEL_EVALUATION_RUN_CANCELLINGMODEL_EVALUATION_RUN_CANCELLEDMODEL_EVALUATION_RUN_SUCCESSFULMODEL_EVALUATION_RUN_PARTIALLY_SUCCESSFULMODEL_EVALUATION_RUN_FAILEDDefault:MODEL_EVALUATION_RUN_STATUS_UNSPECIFIED
pageintegeroptional
Page number.
per_pageintegeroptional
Items per page.
statusesarray<string>optional
Filter by one or more statuses. Empty means no status filter.
candidate_typesarray<string>optional
Filter by one or more candidate model source types (serverless, dedicated, router). Empty means no candidate-type filter.
searchstringoptional
Free-text search across the eval run name, candidate model name and dataset name (case-insensitive substring match). Empty means no search.
sort_bystringoptional
Field to sort by. Defaults to creation date when unspecified.
Allowed:MODEL_EVALUATION_RUN_SORT_FIELD_UNSPECIFIEDMODEL_EVALUATION_RUN_SORT_FIELD_CREATED_ATMODEL_EVALUATION_RUN_SORT_FIELD_STATUSDefault:MODEL_EVALUATION_RUN_SORT_FIELD_UNSPECIFIED
sort_directionstringoptional
Sort direction. Defaults to descending when unspecified.
Allowed:SORT_DIRECTION_UNSPECIFIEDSORT_DIRECTION_ASCSORT_DIRECTION_DESCDefault:SORT_DIRECTION_UNSPECIFIED

6 status codes
200A successful response.
available_candidate_typesarray<string>optional
Full set of candidate model source types the FE can offer in the candidate-type filter UI.
available_statusesarray<string>optional
Full set of statuses the FE can offer in the status filter UI. Returned on every list call so clients never need to hardcode the enum values.
linksobjectoptional
Links to other pages
metaobjectoptional
Meta information about the data set
runsarray<object>optional
Summary view of evaluation runs for the run history list.
401Authentication failed due to invalid credentials.
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.
404The resource was 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.
429The 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.
500There was a server 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.
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: Authentication failed due to invalid credentials. A 404 is returned: The resource was not found. A 429 is returned: The API rate limit has been exceeded. A 500 is returned: There was a server error. Any other status is an error: There was an unexpected error.