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

# Review queue

> The samples your team checks: extracted facts, measurement signals and patterns.



## OpenAPI

````yaml openapi/en/cell.json GET /v1/review/queue
openapi: 3.1.0
info:
  title: Niadra data API
  version: '1'
  description: >-
    Writing, context, history, objects, identity, privacy and governance of one
    space. Every space has a stable address, with the space and the region in
    its name.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: The space, which comes in the source key.
      region:
        default: us-east-1
        description: The region of the space, which also comes in the key.
security: []
paths:
  /v1/review/queue:
    get:
      tags:
        - governance
      summary: Review queue
      description: >-
        The next samples for your team to review: the facts extracted from a
        session, with the evidence behind each one, and the measurement signals
        found in it. The reviewer sees no more than the agent of that purpose
        would, and every sample opened is recorded.


        **Authentication.** Console person token with the `review` role (or
        admin), or a source key with the `admin` scope.
      operationId: review_queue_v1_review_queue_get
      parameters:
        - in: query
          name: limit
          required: false
          schema:
            default: 10
            maximum: 50
            minimum: 1
            title: Limit
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReviewQueue'
              example:
                items:
                  - sample_id: 0192f7d0-6e41-7b5c-8d6e-7f8091a2b3c4
                    session_id: 0192f7d0-1a11-7c22-9d33-4e5f60718293
                    source_id: 0192f79e-11aa-7b20-9f3e-6c1d2e4f5a60
                    channel: voice
                    purpose: customer_service
                    condition: new_extractor_version
                    created_at: '2026-09-22T17:15:00Z'
                    withheld: 0
                    facts:
                      - fact_id: 0192f7a2-5d10-7a8e-b1c4-3f6e8d9a0b12
                        predicate: preferred_visit_time
                        value: morning
                        category: preference
                        sensitive: false
                        evidence_event_ids:
                          - 0192f7a1-6c1e-7c3a-9b1e-5d2f8a4c0e11
                    signals:
                      - signal: use
                        item_id: act_01J8ZK
                        target_id: sig_01J8ZL
                        manifest_hash: sha256:5b1e0c
          description: The next samples to review.
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: The request does not match the contract.
      security:
        - sourceKey: []
        - personToken: []
components:
  schemas:
    ReviewQueue:
      additionalProperties: false
      properties:
        items:
          items:
            $ref: '#/components/schemas/ReviewSampleOut'
          title: Items
          type: array
      required:
        - items
      title: ReviewQueue
      type: object
    Problem:
      additionalProperties: false
      description: RFC 9457 problem details; `code` comes from the versioned error catalog.
      properties:
        code:
          title: Code
          type: string
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Detail
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Request Id
        status:
          title: Status
          type: integer
        title:
          title: Title
          type: string
        type:
          default: about:blank
          title: Type
          type: string
      required:
        - title
        - status
        - code
      title: Problem
      type: object
    ReviewSampleOut:
      additionalProperties: false
      properties:
        channel:
          title: Channel
          type: string
        condition:
          title: Condition
          type: string
        created_at:
          format: date-time
          title: Created At
          type: string
        facts:
          items:
            $ref: '#/components/schemas/ReviewFact'
          title: Facts
          type: array
        purpose:
          anyOf:
            - type: string
            - type: 'null'
          title: Purpose
        sample_id:
          format: uuid
          title: Sample Id
          type: string
        session_id:
          format: uuid
          title: Session Id
          type: string
        signals:
          items:
            $ref: '#/components/schemas/ReviewSignal'
          title: Signals
          type: array
        source_id:
          format: uuid
          title: Source Id
          type: string
        withheld:
          description: Items the sample's purpose does not allow the reviewer to see.
          title: Withheld
          type: integer
      required:
        - sample_id
        - session_id
        - source_id
        - channel
        - condition
        - purpose
        - created_at
        - facts
        - signals
        - withheld
      title: ReviewSampleOut
      type: object
    ReviewFact:
      additionalProperties: false
      properties:
        category:
          title: Category
          type: string
        evidence_event_ids:
          items:
            format: uuid
            type: string
          title: Evidence Event Ids
          type: array
        fact_id:
          format: uuid
          title: Fact Id
          type: string
        predicate:
          title: Predicate
          type: string
        sensitive:
          description: Sensitive items show only the item and the turns that support it.
          title: Sensitive
          type: boolean
        value:
          title: Value
          type: string
      required:
        - fact_id
        - predicate
        - value
        - category
        - evidence_event_ids
        - sensitive
      title: ReviewFact
      type: object
    ReviewSignal:
      additionalProperties: false
      properties:
        item_id:
          title: Item Id
          type: string
        manifest_hash:
          title: Manifest Hash
          type: string
        signal:
          description: '`used`, `repeated`, `contradicted` or `selection_miss`.'
          title: Signal
          type: string
        target_id:
          title: Target Id
          type: string
      required:
        - target_id
        - manifest_hash
        - item_id
        - signal
      title: ReviewSignal
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````