---
title: "Review state of an artifact"
method: GET
path: "/v1/home/review"
tags: ["Home"]
---

# Review state of an artifact

`GET /v1/home/review`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/home/review`
- Auth: HTTP bearer

The live version, whether the caller may review (resolve, assign, approve) and every approval. The Home shell's endpoint; accepts a session cookie or a Bearer token. Comments themselves are read and resolved through the Data comments endpoints.

## Query parameters

- `artifactId` string, required

## Response `200`

Review state

- ReviewState
  - `live_version_id` string, nullable
  - `live_version_no` integer, nullable
  - `can_review` boolean: Caller may resolve, assign and approve.
  - `approvals` object[]
    - `version_id` string
    - `version_no` integer
    - `user_id` string
    - `name` string, nullable
    - `email` string, nullable
    - `created_at` string, date-time
  - `my_approvals` string[]: Version ids the caller (any linked account) approved.

## Other responses

- `400`: Invalid request
- `403`: No access to this artifact

## Changes

- **2026-10-16** `924c2aeaed12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/home/review/get.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)