> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nvisy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reopen a review

> Reopens a resolved review back to `needs_review`. Requires Review.



## OpenAPI

````yaml /api-reference/openapi.json post /workspaces/{workspaceId}/reviews/{reviewId}/reopen
openapi: 3.1.0
info:
  title: Nvisy API
  summary: Document detection and redaction platform
  description: >-
    Nvisy provides intelligent detection of sensitive content in documents,
    redaction pipelines, and reviewer workflows. This API enables document
    upload, detection analysis, redaction, and collaborative review across your
    workspaces.
  termsOfService: https://nvisy.com/legal/terms-of-service
  contact:
    name: Nvisy Support
    url: https://nvisy.com
    email: hello@nvisy.com
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  version: 0.1.0
servers: []
security: []
tags:
  - name: Health
    description: Service health checks
  - name: Capabilities
    description: Read-only reference data describing this deployment
  - name: Accounts
    description: Account management and profile operations
  - name: Identities
    description: 'Account sign-in methods: password and linked providers'
  - name: Avatars
    description: Public avatar image serving
  - name: Authentication
    description: Login, signup, and token management
  - name: Workspaces
    description: Workspace creation and management
  - name: Activities
    description: Workspace activity log and export
  - name: Documents
    description: Document upload, download, and management
  - name: Analytics
    description: Aggregate metrics over a workspace's documents
  - name: Members
    description: Workspace member management
  - name: Invites
    description: Workspace invitation handling
  - name: API Tokens
    description: API token management
  - name: Connections
    description: External provider connections
  - name: Connection Syncs
    description: Connection synchronization runs
  - name: Providers
    description: Inference-provider configuration
  - name: Pipelines
    description: Redaction pipeline configuration
  - name: Detections
    description: Detection analysis and redaction
  - name: Redactions
    description: Redactions produced from a detection, with reviewer edits
  - name: Reviews
    description: Document reviews, the review queue, and their discussion
  - name: Policies
    description: Redaction policy configuration
  - name: Webhooks
    description: Webhook configuration
  - name: Notifications
    description: Account notification management
paths:
  /workspaces/{workspaceId}/reviews/{reviewId}/reopen:
    post:
      tags:
        - Reviews
      summary: Reopen a review
      description: Reopens a resolved review back to `needs_review`. Requires Review.
      parameters:
        - in: path
          name: workspaceId
          description: Workspace identifier.
          required: true
          schema:
            description: Workspace identifier.
            type: string
            format: uuid
          style: simple
        - in: path
          name: reviewId
          description: Unique identifier of the review.
          required: true
          schema:
            description: Unique identifier of the review.
            type: string
            format: uuid
          style: simple
      responses:
        '200':
          description: >-
            Response type for a review: a named discussion on a document with a
            manual

            sign-off lifecycle (0..N per document), opened explicitly. It
            carries a

            `reviewStatus`, a `displayName`, and its `assignees` (0..N
            reviewers); its

            stream is a [`WorkspaceReviewEntry`] timeline.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceReview'
        '401':
          description: >-
            The serialized shape of an HTTP error: the inert wire/OpenAPI-schema
            view

            that [`Error`] renders to at the response boundary.


            It carries no builder logic — [`Error`] is the type handlers
            construct and

            thread through `Result`, and it builds an `ErrorResponse` directly
            in its

            `IntoResponse` impl. `context` and `status` are not part of the JSON
            body

            (`context` is logged, `status` sets the HTTP status line).


            [`Error`]: crate::response::Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >-
            The serialized shape of an HTTP error: the inert wire/OpenAPI-schema
            view

            that [`Error`] renders to at the response boundary.


            It carries no builder logic — [`Error`] is the type handlers
            construct and

            thread through `Result`, and it builds an `ErrorResponse` directly
            in its

            `IntoResponse` impl. `context` and `status` are not part of the JSON
            body

            (`context` is logged, `status` sets the HTTP status line).


            [`Error`]: crate::response::Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: >-
            The serialized shape of an HTTP error: the inert wire/OpenAPI-schema
            view

            that [`Error`] renders to at the response boundary.


            It carries no builder logic — [`Error`] is the type handlers
            construct and

            thread through `Result`, and it builds an `ErrorResponse` directly
            in its

            `IntoResponse` impl. `context` and `status` are not part of the JSON
            body

            (`context` is logged, `status` sets the HTTP status line).


            [`Error`]: crate::response::Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    WorkspaceReview:
      description: >-
        Response type for a review: a named discussion on a document with a
        manual

        sign-off lifecycle (0..N per document), opened explicitly. It carries a

        `reviewStatus`, a `displayName`, and its `assignees` (0..N reviewers);
        its

        stream is a [`WorkspaceReviewEntry`] timeline.
      type: object
      properties:
        assignees:
          description: The reviewers assigned to this review (empty when unassigned).
          type: array
          items:
            $ref: '#/components/schemas/AccountRef'
        author:
          description: Account that opened the review.
          allOf:
            - $ref: '#/components/schemas/AccountRef'
        createdAt:
          description: When the review was created.
          type: string
          format: date-time
        displayName:
          description: The review's title.
          type: string
        documentId:
          description: Document under review.
          type: string
          format: uuid
        id:
          description: Unique identifier of the review.
          type: string
          format: uuid
        reviewStatus:
          description: The review's current status.
          allOf:
            - $ref: '#/components/schemas/ReviewStatus'
        updatedAt:
          description: When the review was last updated.
          type: string
          format: date-time
      required:
        - id
        - documentId
        - displayName
        - author
        - reviewStatus
        - assignees
        - createdAt
        - updatedAt
    ErrorResponse:
      description: >-
        The serialized shape of an HTTP error: the inert wire/OpenAPI-schema
        view

        that [`Error`] renders to at the response boundary.


        It carries no builder logic — [`Error`] is the type handlers construct
        and

        thread through `Result`, and it builds an `ErrorResponse` directly in
        its

        `IntoResponse` impl. `context` and `status` are not part of the JSON
        body

        (`context` is logged, `status` sets the HTTP status line).


        [`Error`]: crate::response::Error
      type: object
      properties:
        message:
          description: User-friendly error message safe for client display.
          type: string
        name:
          description: The error name/type identifier.
          type: string
      required:
        - name
        - message
    AccountRef:
      description: >-
        Public reference to the account behind a resource — whoever created it,

        uploaded it, triggered it, or performed it.


        Reused across resource responses so an account is always presented the
        same

        way: its immutable id (the durable reference) plus a handle and optional

        avatar for display.
      type: object
      properties:
        avatarUrl:
          description: Serve path of the account's avatar, when set.
          type: string
        displayName:
          description: Human-readable display name, when set.
          type: string
        id:
          description: Immutable id of the account.
          type: string
          format: uuid
        username:
          description: Handle of the account (display).
          allOf:
            - $ref: '#/components/schemas/Handle'
      required:
        - id
        - username
    ReviewStatus:
      description: >-
        The review state of a file thread (a file thread is the review of its

        file). `None` on the thread means a workspace thread, which has no
        review.


        Corresponds to the `REVIEW_STATUS` `PostgreSQL` enum. It is derived from
        the

        review's events, never set by a user: a detection makes it
        `NeedsReview`, a

        redaction `InReview`, and verification `Resolved`; a later detection
        reopens

        it to `NeedsReview`.
      oneOf:
        - description: A detection exists; no redaction has been reviewed yet.
          type: string
          const: needs_review
        - description: A redaction (review pass) exists but has not been verified.
          type: string
          const: in_review
        - description: The review has been verified (approved).
          type: string
          const: resolved
    Handle:
      description: >-
        Lowercase, dash-separated identifier used in URLs and as account
        handles.
      type: string
      maxLength: 32
      minLength: 3
      pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

````