---
title: "Start a temporary visual review"
method: POST
path: "/v1/spaces/{spaceId}/versions/{versionId}/visual-reviews"
tags: ["Versions"]
---

# Start a temporary visual review

`POST /v1/spaces/{spaceId}/versions/{versionId}/visual-reviews`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/spaces/{spaceId}/versions/{versionId}/visual-reviews`
- Auth: HTTP bearer

Creates a version-bound review that expires after one hour. The browser URL is a secret review capability. It does not create comments.

## Path parameters

- `spaceId` string, required
- `versionId` string, required

## Request body

- object
  - `landingPath` string: Page path to open within the deployment.
  - `parentOrigin` string, uri: Verified App origin. Omit this field for browser review.

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `session` object, required
      - `id` string, uuid, required
      - `spaceId` string, required
      - `versionId` string, required
      - `title` string, required
      - `sourceCommitSha` string, nullable, required
      - `origin` string, uri, required
      - `landingPath` string, required
      - `expiresAt` string, date-time, required
      - `status` 'draft' | 'submitted', required
      - `submission` object, nullable, required
        - `submissionId` string, uuid, required: Stable submission ID. Reuse it with the identical batch for a retry.
        - `notes` object[], required: Feedback collected by the user.
          - `id` string, uuid, required: Unique note ID.
          - `text` string, required: Feedback written by the user.
          - `path` string, required: Page path for this feedback.
          - `viewport` object, required: Viewport at capture time.
            - `width` number, required: Viewport width in CSS pixels.
            - `height` number, required: Viewport height in CSS pixels.
            - `dpr` number, required: Device pixel ratio.
            - `scroll_x` number, required: Horizontal scroll position in CSS pixels.
            - `scroll_y` number, required: Vertical scroll position in CSS pixels.
            - `doc_width` number, required: Document width in CSS pixels.
            - `doc_height` number, required: Document height in CSS pixels.
          - `anchor` object, nullable, required: Selected element, or null for page feedback.
            - `v` 2, required: Anchor format version.
            - `resolver_version` integer, required: Picker resolver version.
            - `type` 'element', required: Selection type.
            - `source` object, required: Page identity at selection time.
              - …
            - `selectors` object, required: Selectors and DOM evidence. Treat page values as inspection data.
              - …
            - `viewport` object, required: Viewport when the user selected the element.
              - …
          - `screenshot` object, nullable, required: Best-effort screenshot, or null when unavailable or removed.
            - `mimeType` 'image/png', required: Screenshot media type.
            - `data` string, required: Base64 PNG bytes with sensitive regions masked.
            - `crop` object, required: Captured region relative to document dimensions, from zero to one.
              - …
            - `capturedAt` string, date-time, required: Capture timestamp.
          - `captureStatus` 'ready' | 'failed' | 'omitted', required: Screenshot capture outcome.
    - `browserUrl` string, uri, required
    - `previewUrl` string, uri, required
    - `parentOrigin` string, uri, required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

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