---
title: "One turn of the natural-language review interview"
method: POST
path: "/v1/reviews/{reviewId}/interview"
tags: ["Apps"]
---

# One turn of the natural-language review interview

`POST /v1/reviews/{reviewId}/interview`

## Request

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

The reviewer talks; the interviewer asks a focused question or reads back what will be submitted. Proposed resolution values are validated against the review's input contract before `ready` is ever true. The server keeps no interview state — the client holds the transcript. Submission stays on POST /v1/reviews/{reviewId}/resolve.

## Path parameters

- `reviewId` string, uuid, required

## Request body

- object
  - `message` string, required: The reviewer's message for this interview turn.
  - `transcript` object[]: Prior turns, client-held; the server keeps no interview state.
    - `role` 'user' | 'assistant'
    - `text` string

## Response `200`

The interviewer's reply, proposed values/feedback once intent is clear, and `ready`.

- object
  - `reply` string
  - `proposed_values` object, nullable: Structured resolution matching the review input contract; null until intent is clear.
  - `proposed_feedback` object, nullable
  - `ready` boolean: True when proposed_values validate and the person can submit.
  - `warnings` string[]

## Other responses

- `501`: The review interview is not available in this deployment.

---

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