---
title: "Trigger test evaluation for custom timestamp range"
method: POST
path: "/tests/{testId}/evaluate"
tags: ["Monitoring"]
---

# Trigger test evaluation for custom timestamp range

`POST /tests/{testId}/evaluate`

Triggers one-off evaluation of a specific monitoring test for a custom timestamp range.
This allows evaluating tests for historical data or custom time periods outside
the regular evaluation window schedule. It also allows overwriting the existing test results.

## Path parameters

- `testId` string, uuid, required

## Request body

- object
  - `startTimestamp` integer, required — Start timestamp in seconds (Unix epoch)
  - `endTimestamp` integer, required — End timestamp in seconds (Unix epoch)
  - `inferencePipelineId` string, uuid — ID of the inference pipeline to evaluate. If not provided, all inference pipelines the test applies to will be evaluated.
  - `overwriteResults` boolean — Whether to overwrite existing test results

## Response `202`

Evaluation task queued successfully. Timestamps will be aligned to evaluation window boundaries during execution.

- object
  - `message` string, required
  - `pipelineCount` integer, required — Number of inference pipelines the test was queued for evaluation on
  - `requestedStartTimestamp` integer, required — The start timestamp you requested (in seconds)
  - `requestedEndTimestamp` integer, required — The end timestamp you requested (in seconds)
  - `tasks` object[], required — Array of background task information for each pipeline evaluation
    - `taskResultUrl` string, required — URL to check the status of this background task
    - `taskResultId` string, uuid, required — ID of the background task
    - `pipelineId` string, uuid, required — ID of the inference pipeline this task is for

## Other responses

- `default` — Unexpected error.

---

[API](https://skmtc.net/openlayer/apis/openlayer-api.md) · [All operations](https://skmtc.net/openlayer/apis/openlayer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openlayer/openlayer-api/versions/d0e74f00c900/schema)