---
title: "Create conversation review"
method: POST
path: "/conversations/{conversationId}/review"
---

# Create conversation review

`POST /conversations/{conversationId}/review`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/conversations/{conversationId}/review`
- Auth: HTTP bearer

Requires `conversations:reviews:write`. Returns 409 if a review or handoff is already open.

## Path parameters

- `conversationId` string, required

## Request body

- object
  - `reasonCode` 'ai_response_issue' | 'knowledge_gap' | 'policy_compliance' | 'guest_experience' | 'booking_payment' | 'other'
  - `note` string
  - `assignedOperatorId` string

## Response `201`

Success

- ConversationReviewSnapshot
  - `ok` true, required
  - `conversationId` string, required
  - `reviewCaseId` string, required
  - `status` union, required
    - 'requested'
    - 'resolved'
    - 'cancelled'
  - `reasonCode` union, required
    - 'ai_response_issue'
    - 'knowledge_gap'
    - 'policy_compliance'
    - 'guest_experience'
    - 'booking_payment'
    - 'other'
  - `note` string
  - `requestedByOperatorId` string, required
  - `requestedByOperatorName` string
  - `assignedOperatorId` string
  - `assignedOperatorName` string
  - `requestedAt` string, required
  - `resolvedAt` string

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)