---
title: "Updates an evaluation"
method: PATCH
path: "/evaluations/{evaluation_token}"
tags: ["Evaluations"]
---

# Updates an evaluation

`PATCH /evaluations/{evaluation_token}`

Updates an existing unresolved evaluation (waiting on required inputs), data supplied in the request body will be merged with data supplied from the initial `POST` request.
Note that `null` values supplied for fields in the request body are treated as "do not change" and no updates will happen with those fields.

## Request body

- object

## Response `200`

Evaluation missing required inputs

- object
  - `status_code` string
  - `error` object
  - `timestamp` number
  - `evaluation_token` string
  - `entity_token` string
  - `application_token` string
  - `application_version_id` number
  - `required` object[] — The required fields for this workflow
    - `key` string
    - `type` string
    - `description` string
    - `regex` string
    - `properties` object
  - `optional` object[] — The optional fields for this workflow
    - `key` string
    - `type` string
    - `description` string
    - `regex` string
    - `properties` object

## Other responses

- `201` — Evaluation updated

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) · [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alloy/alloy-api/revisions/405799de4d2a/schema)