---
title: "Raise a Human Review on an app (optionally linked to a run)"
method: POST
path: "/v1/apps/{id}/reviews"
tags: ["Apps"]
---

# Raise a Human Review on an app (optionally linked to a run)

`POST /v1/apps/{id}/reviews`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/apps/{id}/reviews`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `run_id` string, uuid
  - `kind` 'resolution' | 'approval' | 'data_request' | 'judgment', required
  - `question` string, required
  - `context` object
  - `input_contract` object, required: JSON Schema (2020-12 subset) the resolution values must satisfy.
  - `team_id` string, uuid

## Response `201`

The review.

- AppReview: A Human Review — resolves a matter now and captures feedback for the app's future (BR-7).
  - `id` string, uuid
  - `app_id` string, uuid
  - `run_id` string, uuid, nullable
  - `kind` 'resolution' | 'approval' | 'data_request' | 'judgment'
  - `status` 'open' | 'assigned' | 'resolved' | 'expired' | 'cancelled'
  - `question` string
  - `context` object
  - `input_contract` object
  - `raised_by` object
  - `assignee_team_id` string, uuid, nullable
  - `assignee_user_id` string, uuid, nullable
  - `resolution` object, nullable
  - `feedback` object, nullable
  - `expires_at` string, date-time, nullable
  - `resolved_at` string, date-time, nullable

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)