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

# Remind reviewers

> Sends a reminder notification to all pending reviewers of a review. Called by the daemon when a HUG review's `remind_every_minutes` interval elapses. Returns the updated review data.

Requires a realm operator (or higher) on the realm that owns the review, or a daemon realm token (`cliq_dt_…`) from the same realm.



## OpenAPI

````yaml /openapi/hub-by-tag/hub-reviews.yaml post /v1/reviews/remind
openapi: 3.0.3
info:
  title: 'CliqHub API: Reviews'
  version: 1.0.0
  description: >-
    Human-in-the-loop (HUG) reviews. When a team reaches a review phase, the
    agent opens a

    review; CliqHub notifies the reviewers (people and channels named in the
    team or at run

    start) and shows the review in their inbox. A reviewer reads it, can chat
    with the agent,

    and gives a verdict (`PASS`, `REJECT` or `ROUTE:<phase>`); with an `all`
    policy every group

    must answer first. The agent then picks up the decision and acknowledges it.


    A review is `pending`, then `decided`, then `completed` once the agent
    acknowledged it, or

    `expired` when nobody answered in time (4 hours by default).
servers:
  - url: https://{host}
    variables:
      host:
        default: cliqhub.io
        description: CliqHub host
security: []
tags:
  - name: Reviews
    description: >-
      Human-in-the-loop (HUG) reviews. When a team reaches a review phase, the
      agent opens a

      review; CliqHub notifies the reviewers (people and channels named in the
      team or at run

      start) and shows the review in their inbox. A reviewer reads it, can chat
      with the agent,

      and gives a verdict (`PASS`, `REJECT` or `ROUTE:<phase>`); with an `all`
      policy every group

      must answer first. The agent then picks up the decision and acknowledges
      it.


      A review is `pending`, then `decided`, then `completed` once the agent
      acknowledged it, or

      `expired` when nobody answered in time (4 hours by default).
paths:
  /v1/reviews/remind:
    post:
      tags:
        - Reviews
      summary: Remind reviewers
      description: >-
        Sends a reminder notification to all pending reviewers of a review.
        Called by the daemon when a HUG review's `remind_every_minutes` interval
        elapses. Returns the updated review data.


        Requires a realm operator (or higher) on the realm that owns the review,
        or a daemon realm token (`cliq_dt_…`) from the same realm.
      operationId: POST_v1_reviews_remind
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                review_id:
                  type: string
                  format: uuid
                  description: Review to remind on.
              required:
                - review_id
            examples:
              default:
                value:
                  review_id: 4a3b2c1d-0e9f-4a8b-9c7d-6e5f4a3b2c1d
      responses:
        '200':
          description: Success — reminder sent.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    enum:
                      - true
                    description: Always `true` on success.
                  data: 85f1a30c-d593-4cb2-8797-900eb0c8aa53
                required:
                  - ok
              example:
                ok: true
                data:
                  review_id: 4a3b2c1d-0e9f-4a8b-9c7d-6e5f4a3b2c1d
                  status: pending
        '404':
          description: '`not_found`: Review does not exist.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HubErr'
              examples:
                not_found:
                  summary: not_found
                  value:
                    ok: false
                    error:
                      code: not_found
                      message: Review not found
      security:
        - HubBearer: []
components:
  schemas:
    HubErr:
      type: object
      required:
        - ok
        - error
      description: >-
        Every failure. Route-policy denials (401/403/404, and 400 when neither
        realm_id nor org_id was sent) answer `error` as `{ code, message }`;
        errors raised by the endpoint answer `error` as the message with the
        code beside it in `code`. Every error has a code. See
        [Errors](/hub-api/errors).
      properties:
        ok:
          type: boolean
          description: Always false on error
        error:
          description: The message, or `{ code, message }` for an access denial.
          oneOf:
            - type: string
            - type: object
              required:
                - code
                - message
              properties:
                code:
                  type: string
                message:
                  type: string
        code:
          type: string
          description: Stable error code of an endpoint error.
        details:
          type: object
          additionalProperties: true
          description: Structured detail, when there is some.

````

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