---
title: "Create Review"
method: POST
path: "/v1/livereviews/{section_uuid}/{content_container_uuid}/reviews"
tags: ["Review"]
---

# Create Review

`POST /v1/livereviews/{section_uuid}/{content_container_uuid}/reviews`

## Request

- Base URL: `https://livereviews.viafoura.co`
- URL: `https://livereviews.viafoura.co/v1/livereviews/{section_uuid}/{content_container_uuid}/reviews`
- Auth: one of:
  - HTTP basic
  - API key in header `X-REQUEST_SIGNATURE`

Create a review in a specific container.

## Path parameters

- `section_uuid` string, uuid, required
- `content_container_uuid` string, uuid, required

## Request body

- ContentRequest, nullable
  - `content` string, nullable
  - `rating` integer: Star rating 1-5. On edit, 0 is a sentinel meaning "clear the stored rating" (allowed only where the container permits ratings-less reviews, else 409); 0 is not a valid rating on create (400).
  - `media_uuids` string[], nullable
  - `metadata` ContentInstanceMetadata, nullable: Metadata captured or assigned during content creation
    - `author_host_section_uuid` string, uuid, nullable: Identifier for where the author of the content is hosted. Facilitates looking up information about the author
    - `origin_title` string, nullable: Title of the location where the content was created
    - `origin_summary` string, nullable: Short description about the location where the content was created
    - `origin_url` string, nullable: Location where the content was created
    - `origin_image_url` string, nullable: Location of the icon or thumbnail representing the origin
    - `origin_image_alt` string, nullable: Text description of the origin_image_url
    - `origin_ip_address` string, nullable: Ip address of the user during content creation. Only returned to client permission bearers

## Response `201`

Created

- ContentCreateResponse
  - `content_uuid` string, uuid

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/viafoura/apis/reviews-api.md) - [All operations](https://skmtc.dev/viafoura/apis/reviews-api/llms.txt) - [OpenAPI document](https://skmtc.dev/viafoura/apis/reviews-api/revisions/4879934048b7?raw)