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

# Review a Run

> Rate how well one finished Run did its part, after you have used its result. The review is private to Glasser.

Rate what this one Run was expected to contribute, not the whole task. The first review of a Run is kept: a repeat returns `200` with `already_reviewed` and is not saved. A review never changes the Run, its result or its charge.


## OpenAPI

````yaml /openapi.json post /v1/runs/{runId}/review
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    One key, no contract, pay per call, across paid APIs bought wholesale. Every
    response carries x-request-id; every error body carries the same envelope.
servers:
  - url: https://api.glasser.ai
security: []
tags:
  - name: Solutions
  - name: Endpoints
  - name: Runs
  - name: Balance
paths:
  /v1/runs/{runId}/review:
    post:
      tags:
        - Runs
      summary: Review a Run
      description: >-
        Rate how well one finished Run did its part, after you have used its
        result, with an optional reason of at most 200 characters. The review is
        private to Glasser and never changes the Run, its result or its charge.


        - **201:** the review was recorded.

        - **200:** the Run already has a review. The first review is kept; this
        submission is not saved.

        - **409:** the Run has not finished yet.
      operationId: runs-review
      parameters:
        - name: runId
          in: path
          schema:
            type: string
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$
            format: uuid
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                rating:
                  type: string
                  enum:
                    - exceeds_expectations
                    - meets_expectations
                    - partially_meets_expectations
                    - does_not_meet_expectations
                    - unable_to_assess
                  description: >-
                    Rate what this one Run was expected to contribute, not the
                    whole task. Example: the Run was asked for 20 companies that
                    match the criteria and have verified emails.
                    exceeds_expectations: did its part plus more that is useful
                    (all 20 match and all 20 have verified emails, plus recent
                    buying signals usable for outreach). meets_expectations: did
                    its part (all 20 match and all 20 have verified emails).
                    partially_meets_expectations: a known shortfall (all 20
                    match the criteria, only 5 have verified emails).
                    does_not_meet_expectations: the result is not usable for its
                    part (none are in the target industry). unable_to_assess:
                    not enough evidence to judge (emails returned with no
                    verification status and no way to tell). If another Run was
                    meant to verify the emails, a Run that found 20 matching
                    companies meets expectations.
                reason:
                  anyOf:
                    - type: string
                      maxLength: 200
                      description: >-
                        Optional. Why you chose the rating, in at most 200
                        characters: what was missing, wrong or especially
                        useful. Omit private data.
                    - type: 'null'
              required:
                - rating
              additionalProperties: false
        required: true
      responses:
        '200':
          description: the Run already has a review; the first one is kept
          content:
            application/json:
              schema:
                type: object
                properties:
                  review_id:
                    type: string
                  run_id:
                    type: string
                  status:
                    type: string
                    enum:
                      - recorded
                      - already_reviewed
                    description: >-
                      recorded: this submission was saved. already_reviewed:
                      this Run already has a review; the first one is kept and
                      this submission was not saved.
                  created_at:
                    type: string
                    description: When the kept review was submitted.
                    format: date-time
                required:
                  - review_id
                  - run_id
                  - status
                  - created_at
                additionalProperties: false
        '201':
          description: a newly recorded review
          content:
            application/json:
              schema:
                type: object
                properties:
                  review_id:
                    type: string
                  run_id:
                    type: string
                  status:
                    type: string
                    enum:
                      - recorded
                      - already_reviewed
                    description: >-
                      recorded: this submission was saved. already_reviewed:
                      this Run already has a review; the first one is kept and
                      this submission was not saved.
                  created_at:
                    type: string
                    description: When the kept review was submitted.
                    format: date-time
                required:
                  - review_id
                  - run_id
                  - status
                  - created_at
                additionalProperties: false
        '400':
          description: ValidationFailed
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedEncoded'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenEncoded'
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundEncoded'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictEncoded'
        '429':
          description: RateLimited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitedEncoded'
      security:
        - bearer: []
components:
  schemas:
    ValidationFailedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_failed
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    UnauthorizedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - unauthorized
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    ForbiddenEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - forbidden
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    NotFoundEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - not_found
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    ConflictEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - conflict
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    RateLimitedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - rate_limited
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
  securitySchemes:
    bearer:
      type: http
      scheme: Bearer

````

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