---
title: "Manually open an Expectation window"
method: POST
path: "/expectations/{id}/trigger_evaluation"
tags: ["expectations", "Expectation Evaluations"]
---

# Manually open an Expectation window

`POST /expectations/{id}/trigger_evaluation`

Manually open an Expectation window

## Path parameters

- `id` integer, required

## Response `201`

The Expectations object.

- ExpectationEvaluationEntity — ExpectationEvaluationEntity model
  - `id` integer — ExpectationEvaluation ID
  - `workspace_id` integer — Workspace ID. `0` means the default workspace.
  - `expectation_id` integer — Expectation ID.
  - `status` 'open' | 'success' | 'late' | 'missing' | 'invalid' — Evaluation status.
  - `opened_via` 'schedule' | 'manual' | 'upload' — How the evaluation window was opened.
  - `opened_at` string, date-time — When the evaluation row was opened.
  - `window_start_at` string, date-time — Logical start of the candidate window.
  - `window_end_at` string, date-time — Actual candidate cutoff boundary for the window.
  - `deadline_at` string, date-time — Logical due boundary for schedule-driven windows.
  - `late_acceptance_cutoff_at` string, date-time — Logical cutoff for late acceptance, when present.
  - `hard_close_at` string, date-time — Hard stop after which the window may not remain open.
  - `closed_at` string, date-time — When the evaluation row was finalized.
  - `matched_files` object[] — Captured evidence for files that matched the window.
  - `missing_files` object[] — Captured evidence for required files that were missing.
  - `criteria_errors` string[] — Captured criteria failures for the window, including file-scoped FTS errors and returned validation details.
  - `summary` object — Compact evaluator summary payload.
  - `created_at` string, date-time — Creation time.
  - `updated_at` string, date-time — Last update time.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

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