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

# List triage approvals

> Everyone sees their own requests. Reviewers with the Can approve or reject triage requests permission (`heeler.approve_triage_request`) also see other requests, subject to access to every project when project access control applies. Returns one page of the current queue. After deciding requests, fetch page 1 again to avoid skipping requests as the queue shrinks. Non-pending list items omit finding_total, finding_previews, project_names, skip_count and closed_by_rescan; fetch the detail for these fields. Pending false-positive requests closed by the latest full scan are hidden unless rescan=closed. Invalid status returns 400; other unrecognized filter values are ignored. Requests that are being processed may be briefly absent.



## OpenAPI

````yaml /api-reference/openapi.json get /triage/approvals
openapi: 3.0.0
info:
  title: Corgea API
  version: 1.0.0
  description: >-
    API for interacting with Corgea's scanning and vulnerability management
    features
servers:
  - url: https://www.corgea.app/api/v1
    description: Production server
  - url: https://eu.corgea.app/api/v1
    description: EU production server
security:
  - CorgeaToken: []
  - BearerAuth: []
paths:
  /triage/approvals:
    get:
      tags:
        - Triage
      summary: List triage approvals
      description: >-
        Everyone sees their own requests. Reviewers with the Can approve or
        reject triage requests permission (`heeler.approve_triage_request`) also
        see other requests, subject to access to every project when project
        access control applies. Returns one page of the current queue. After
        deciding requests, fetch page 1 again to avoid skipping requests as the
        queue shrinks. Non-pending list items omit finding_total,
        finding_previews, project_names, skip_count and closed_by_rescan; fetch
        the detail for these fields. Pending false-positive requests closed by
        the latest full scan are hidden unless rescan=closed. Invalid status
        returns 400; other unrecognized filter values are ignored. Requests that
        are being processed may be briefly absent.
      operationId: listTriageApprovals
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: page_size
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 20
        - name: status
          in: query
          schema:
            type: string
            enum:
              - pending
              - approved
              - rejected
              - withdrawn
            default: pending
        - name: q
          in: query
          schema:
            type: string
        - name: project
          in: query
          schema:
            type: string
        - name: requester
          in: query
          schema:
            type: string
        - name: reviewer
          in: query
          schema:
            type: string
        - name: severity
          in: query
          schema:
            type: string
        - name: decision
          in: query
          schema:
            type: string
            enum:
              - false_positive
              - accepted_risk
        - name: mine
          in: query
          schema:
            type: string
            enum:
              - requested
              - review
        - name: rec
          in: query
          schema:
            type: string
            enum:
              - has
              - none
              - approve
              - reject
        - name: rescan
          in: query
          schema:
            type: string
            enum:
              - closed
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - ok
                  approvals:
                    type: array
                    items:
                      $ref: '#/components/schemas/TriageApproval'
                  page:
                    type: integer
                  total_pages:
                    type: integer
                  total_approvals:
                    type: integer
        '400':
          description: Invalid request
        '401':
          description: Missing or invalid token
        '403':
          description: Insufficient permissions or plan access
        '405':
          description: Unsupported HTTP method
components:
  schemas:
    TriageApproval:
      type: object
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
        source:
          type: string
        target_status:
          type: string
        justification:
          type: string
        accepted_risk_expiry_date:
          type: string
          format: date-time
          nullable: true
        rule:
          type: object
        source_metadata:
          type: object
        requires_approval:
          type: boolean
        requested_by:
          type: integer
          nullable: true
        approved_by:
          type: integer
          nullable: true
        rejected_by:
          type: integer
          nullable: true
        created_at:
          type: string
          format: date-time
        reviewed_at:
          type: string
          format: date-time
          nullable: true
        applied_at:
          type: string
          format: date-time
          nullable: true
        counts:
          type: object
          properties:
            matched:
              type: integer
            unmatched:
              type: integer
            ambiguous:
              type: integer
            applied:
              type: integer
            conflicts:
              type: integer
        decision_label:
          type: string
        requester:
          type: object
          properties:
            id:
              type: integer
              nullable: true
            name:
              type: string
              nullable: true
        review_comment:
          type: string
          nullable: true
        finding_total:
          type: integer
        finding_previews:
          type: array
          maxItems: 3
          items:
            type: object
            properties:
              kind:
                type: string
                enum:
                  - sast
                  - sca
              id:
                type: string
              title:
                type: string
              severity:
                type: string
              location:
                type: string
        project_names:
          type: array
          items:
            type: string
        skip_count:
          type: integer
        closed_by_rescan:
          type: boolean
        can_review:
          type: boolean
        is_requester:
          type: boolean
        suggestion:
          type: object
          nullable: true
        investigation:
          type: object
          nullable: true
  securitySchemes:
    CorgeaToken:
      type: apiKey
      in: header
      name: CORGEA-TOKEN
      description: >-
        API key for authentication API tokens belonging to inactive users are
        rejected.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: OAuth2 access token (JWT) in the Authorization header

````

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