---
title: "Upsert review"
method: PUT
path: "/reviews"
tags: ["Reviews"]
---

# Upsert review

`PUT /reviews`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/reviews`
- Auth: HTTP bearer

Creates or updates a review for a call.

**Review Statuses:**
- `No Review Status` - Default state
- `Pending Review` - Waiting for review
- `In Progress` - Currently being reviewed
- `Completed` - Review finished
- `Not Needed` - No review required

**Review Tags:**
- `Successful` - Call achieved its goal
- `Technical Issue` - Technical problems occurred
- `Wrong Number` - Reached wrong contact
- `No Answer` - Customer didn't answer
- `Needs Review` - Flagged for further review

## Request body

- object
  - `workspaceId` string, uuid, required: Workspace ID
  - `callId` string, uuid, required: Call ID
  - `reviewAssignee` string, uuid, nullable: Assignee user ID (deprecated)
  - `reviewStatus` 'No Review Status' | 'Pending Review' | 'In Progress' | 'Completed' | 'Not Needed': Review status
  - `reviewTag` 'Successful' | 'Technical Issue' | 'Wrong Number' | 'No Answer' | 'Needs Review' | 'null', nullable: Review tag
  - `reviewNotes` string, nullable: Review notes

## Response `200`

Review created or updated

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `review` object, required
        - `id` string, required
        - `callId` string, required
        - `workspaceId` string, required
        - `reviewAssignee` string, uuid, nullable, required
        - `reviewStatus` 'No Review Status' | 'Pending Review' | 'In Progress' | 'Completed' | 'Not Needed', required
        - `reviewTag` 'Successful' | 'Technical Issue' | 'Wrong Number' | 'No Answer' | 'Needs Review' | 'null', nullable, required
        - `reviewNotes` string, nullable
        - `createdAt` string, required
        - `updatedAt` string, required

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `500`: Server error

---

[API](https://skmtc.dev/freyavoice/apis/freyavoice-api.md) - [All operations](https://skmtc.dev/freyavoice/apis/freyavoice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freyavoice/apis/freyavoice-api/revisions/153d120f0c73?raw)