---
title: "Create a Review for an Entity"
method: POST
path: "/entities/{entity_token}/reviews"
tags: ["Reviews"]
deprecated: true
---

# Create a Review for an Entity

`POST /entities/{entity_token}/reviews`

> **Deprecated.**

<Callout type="warning" title="Deprecated Warning">
  This endpoint is deprecated in favor of Journeys.
</Callout>

When an evaluation is assigned a “Manual Review” outcome, it goes to the Review Queue. While evaluations can be managed in the dashboard, it is also possible to change a status via API.

This endpoint can only be used for non-Journey evaluations. To review Journey or Entity applications, see the Journeys section.

**A few things to note:**
  * The agent whose email you include in the body of the request must be an agent on the account (View agents on the account via the main page of your account under "Agents").
  * The chosen outcome for the evaluation, as well as the reason given for that outcome in the body of the API request, must perfectly match those set up in Settings --> Review Reasons.

## Path parameters

- `entity_token` string, required

## Headers

- `Authorization` string — Basic authorization header per the OAuth Client Authorization Header standard. The format is `Basic <auth_string>`, where `<auth_string>` is the base64 encoding of the string `token:secret` (check [Authentication Guide](https://developer.alloy.com/public/docs/authentication-guide) for details).
- `alloy-workflow-token` string — If you have migrated to the new API Key Settings page and are using account-level API keys for authentication, this header is required to specify the workflow for the evaluation unless it is provided in the request body. If you have not migrated yet, this header is optional, as the workflow will be determined by the Authorization header using workflow_token.

## Request body

- Schema — unresolved $ref

## Response `200`

Review

- Items — unresolved $ref

---

[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)