Dynamiq
Evaluations

List online evaluation runs

Lists the runs recorded by an online evaluation, most recent first. Each run corresponds to one sampled app trace and carries its status, score, and the trace_id it scored. Filter by status with the status query parameter.

GET
/v1/app-evaluations/{evaluation_id}/runs

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.

Query Parameters

status?string

Filter runs by status.

page?integer

Page number (1-based).

page_size?integer

Number of items per page. Values below the minimum or above the maximum are clamped to the nearest bound.

sort?string

Comma-separated sort fields. Prefix a field with - for descending order, e.g. sort=-started_at.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/app-evaluations/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "evaluation_id": "4108ec8e-6efd-4b9b-bace-0bb4c296c324",
      "trace_id": "df570c03-5a03-4cea-8df0-c162d05127ac",
      "input": {},
      "status": "pending",
      "score": {
        "value": 0,
        "comment": "string"
      },
      "error": {},
      "created_at": "2019-08-24T14:15:22Z",
      "started_at": "2019-08-24T14:15:22Z",
      "ended_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 0,
    "page_count": 0,
    "total_count": 0
  }
}
{
  "error": {
    "code": "bad_request",
    "message": "Bad Request",
    "details": {
      "input": "cannot be blank"
    }
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

Update an online evaluation

Updates an online evaluation's runtime settings — `name`, `description`, `enabled`, `sample_rate`, `input_transformer`, and the metric version (`metric_version_id`). The target metric itself is immutable; the new version must belong to the same metric.

List metrics

Lists the metrics of a project, ordered by `name` by default. The `project_id` query parameter is required.