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

# List pending workspace evidence reviews

> Lists evidencing releases with an unapproved evidence PR. Supply page or pageSize to filter and paginate stored review observations while live policy and eligibility refresh in the background. Unknown or expired observations do not grant eligibility; verified closed/merged PRs are excluded. Omitting both pagination parameters retains the full workspace list with live checks and does not apply scope.



## OpenAPI

````yaml /api-reference/openapi.json get /api/reviews/pending
openapi: 3.1.0
info:
  title: LaneSync API
  description: >-
    REST API for LaneSync release governance — milestones, evidence, quality,
    and sync.
  version: 1.0.0
  contact:
    name: LaneSync
    url: https://lanesync.dev
servers:
  - url: https://lanesync.dev
    description: Hosted SaaS
security: []
tags:
  - name: Health
    description: Liveness and readiness
  - name: Auth
    description: GitHub OAuth and sessions
  - name: Dashboard
    description: Org-wide milestone views
  - name: Milestones
    description: Release pipeline and deploy gates
  - name: Repos
    description: Repository bootstrap and configuration
  - name: Sync
    description: GitHub sync triggers
  - name: Evidence
    description: CI evidence upload (no session)
  - name: Quality
    description: Quality scorecards and exports
  - name: Projects
    description: Multi-repo release projects
  - name: Team
    description: Workspace members and invites
  - name: Webhook
    description: GitHub App webhooks
  - name: Reviews
    description: Live evidence reviewer policy and eligibility
  - name: History
    description: Recorded shipped releases
  - name: MCP
    description: Remote MCP connection, OAuth, and personal keys
paths:
  /api/reviews/pending:
    get:
      tags:
        - Reviews
      summary: List pending workspace evidence reviews
      description: >-
        Lists evidencing releases with an unapproved evidence PR. Supply page or
        pageSize to filter and paginate stored review observations while live
        policy and eligibility refresh in the background. Unknown or expired
        observations do not grant eligibility; verified closed/merged PRs are
        excluded. Omitting both pagination parameters retains the full workspace
        list with live checks and does not apply scope.
      operationId: getPendingReviews
      parameters:
        - $ref: '#/components/parameters/Page'
        - $ref: '#/components/parameters/PageSize'
        - name: scope
          in: query
          description: >-
            Applies before pagination. mine includes only reviews with fresh,
            verified eligibility; workspace includes unknown or ineligible
            reviews.
          schema:
            type: string
            enum:
              - mine
              - workspace
            default: mine
      responses:
        '200':
          description: Pending reviews
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/PageInfo'
                  workspaceTotal:
                    type: integer
                    description: >-
                      All visible workspace reviews, independently of scope and
                      page; present in paginated mode.
                  unknown:
                    type: integer
                    description: >-
                      Workspace reviews with stale or unknown eligibility;
                      present in paginated mode.
                  reviews:
                    type: array
                    items:
                      allOf:
                        - $ref: '#/components/schemas/ReleaseReviewDetail'
                        - type: object
                          properties:
                            milestoneUrl:
                              type: string
                              nullable: true
                            updatedAt:
                              type: string
                              format: date-time
                required:
                  - reviews
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          description: Reviews could not be loaded
      security:
        - sessionCookie: []
components:
  parameters:
    Page:
      name: page
      in: query
      description: >-
        Supplying page or pageSize enables pagination. Both omitted retains the
        legacy response. Filters described as paginated-only require pagination.
      schema:
        type: integer
        minimum: 1
        maximum: 100000
        default: 1
    PageSize:
      name: pageSize
      in: query
      description: Number of rows or release groups per page.
      schema:
        type: integer
        enum:
          - 10
          - 25
          - 50
        default: 25
  schemas:
    PageInfo:
      type: object
      description: >-
        Present when page or pageSize is supplied. total counts all matches, and
        pages is at least 1 even for an empty collection. An out-of-range page
        can return no rows.
      properties:
        page:
          type: integer
          minimum: 1
          maximum: 100000
        pageSize:
          type: integer
          enum:
            - 10
            - 25
            - 50
        total:
          type: integer
          minimum: 0
        pages:
          type: integer
          minimum: 1
      required:
        - page
        - pageSize
        - total
        - pages
    ReleaseReviewDetail:
      type: object
      properties:
        milestoneId:
          type: string
          format: uuid
        org:
          type: string
        repo:
          type: string
        version:
          type: string
        evidencePrNumber:
          type:
            - integer
            - 'null'
          minimum: 1
        evidencePrUrl:
          type:
            - string
            - 'null'
          format: uri
        eligibility:
          type: object
          properties:
            status:
              type: string
              enum:
                - eligible
                - ineligible
                - unknown
            login:
              type:
                - string
                - 'null'
            reason:
              type: string
          required:
            - status
            - login
            - reason
        policy:
          anyOf:
            - allOf:
                - $ref: '#/components/schemas/ReleaseReviewPolicy'
            - type: 'null'
        policyStatus:
          type: string
          enum:
            - available
            - unknown
        approvalEffects:
          type: object
          properties:
            status:
              type: string
              enum:
                - configured
                - unknown
            summary:
              type: string
          required:
            - status
            - summary
        reviewState:
          type: string
          enum:
            - open
            - closed
            - merged
            - unknown
      required:
        - milestoneId
        - org
        - repo
        - version
        - evidencePrNumber
        - evidencePrUrl
        - eligibility
        - policy
        - policyStatus
        - approvalEffects
        - reviewState
    ReleaseReviewPolicy:
      type: object
      properties:
        minApprovals:
          type: integer
          minimum: 0
        teams:
          type: array
          items:
            type: string
        deploymentTarget:
          type: string
        promotion:
          type: string
          enum:
            - manual
            - auto
        requiresEvidenceApproval:
          type: boolean
      required:
        - minApprovals
        - teams
        - deploymentTarget
        - promotion
        - requiresEvidenceApproval
    Error:
      type: object
      properties:
        error:
          type: string
  responses:
    BadRequest:
      description: Validation error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing or invalid session
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Not a workspace member
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    sessionCookie:
      type: apiKey
      in: cookie
      name: connect.sid
      description: GitHub OAuth session cookie

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.