Dynamiq
Evaluations

Delete an evaluation

Deletes an evaluation run along with its workflow runs, metric scores, and results.

DELETE
/v1/evaluations/{evaluation_id}

Authorization

personalAccessToken
AuthorizationBearer <token>

Personal Access Token of a Dynamiq user — the only credential accepted by the management API (api.*). Prefix dyn_pat_ (legacy uak_ tokens still authenticate). Send as Authorization: Bearer <token>.

In: header

Path Parameters

evaluation_id*string

Evaluation UUID.

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/evaluations/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "message": "deleted"
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "forbidden",
    "message": "Forbidden"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

Get an evaluation

Returns a single evaluation run, including its status and configuration.

Rerun a failed evaluation

Reruns only the failed tasks of a finished evaluation, reusing the run's existing configuration. The failed workflow and metric runs are discarded and re-queued, and the run's status returns to `running`. Returns `400` if the evaluation is still running or has no failed tasks to rerun.