---
title: "Evaluate decision"
method: POST
path: "/api/projects/{project}/evaluate/{key}"
tags: ["Evaluation"]
---

# Evaluate decision

`POST /api/projects/{project}/evaluate/{key}`

Evaluates a decision model with the provided context and returns the result. Optionally include trace information for debugging.

## Path parameters

- `project` string, required
- `key` string, required

## Request body

- EvaluateRequest — Request body for decision evaluation
  - `context` object, required — Input data for the decision model. The structure depends on your decision model's expected input.
  - `trace` boolean, nullable — When true, includes detailed trace information in the response for debugging purposes.

## Response `200`

Evaluation result

- EvaluateResponse — Response from decision evaluation
  - `result` object — The output from the decision model evaluation
  - `trace` object, nullable — Detailed trace information (only included when trace=true in request)
  - `details` EvaluateDetailsResponse — Metadata about the evaluation
    - `releaseId` string, nullable — ID of the release used for evaluation
    - `versionId` string, nullable — Version ID of the decision model

## Other responses

- `400` — Invalid request or evaluation error
- `401` — Unauthorized - invalid or missing access token
- `404` — Project or decision model not found

---

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