> ## 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.

# Avaliar um Run

> Avalie o quanto um Run finalizado cumpriu sua parte, depois de usar o resultado. A avaliação é privada para a Glasser.

Avalie o que este Run deveria contribuir, não a tarefa inteira. A primeira avaliação de um Run é mantida: uma repetição retorna `200` com `already_reviewed` e não é salva. Uma avaliação nunca altera o Run, o resultado ou a cobrança.


## OpenAPI

````yaml /openapi.pt.json post /v1/runs/{runId}/review
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    Uma chave, sem contrato, pagamento por chamada, para todas as APIs pagas
    adquiridas no atacado. Cada resposta contém x-request-id; cada corpo de erro
    contém o mesmo 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: Avaliar um Run
      description: >-
        Avalie o quanto um Run finalizado cumpriu sua parte, depois de usar o
        resultado, com um motivo opcional de até 200 caracteres. A avaliação é
        privada para a Glasser e nunca altera o Run, o resultado ou a cobrança.


        - **201:** a avaliação foi registrada.

        - **200:** o Run já tem uma avaliação. A primeira é mantida; este envio
        não é salvo.

        - **409:** o Run ainda não terminou.
      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: >-
                    Avalie o que este Run deveria contribuir, não a tarefa
                    inteira. Exemplo: o Run deveria retornar 20 empresas que
                    atendam aos critérios e tenham e-mails verificados.
                    exceeds_expectations: cumpriu sua parte e trouxe mais
                    informações úteis (as 20 atendem e as 20 têm e-mails
                    verificados, além de sinais de compra recentes úteis para
                    prospecção). meets_expectations: cumpriu sua parte (as 20
                    atendem e as 20 têm e-mails verificados).
                    partially_meets_expectations: uma falha conhecida (as 20
                    atendem aos critérios, só 5 têm e-mails verificados).
                    does_not_meet_expectations: o resultado não serve para sua
                    parte (nenhuma está no setor-alvo). unable_to_assess: não há
                    evidências suficientes para julgar (e-mails retornados sem
                    status de verificação e sem como saber). Se outro Run
                    deveria verificar os e-mails, um Run que encontrou 20
                    empresas que atendem aos critérios atende às expectativas.
                reason:
                  anyOf:
                    - type: string
                      maxLength: 200
                      description: >-
                        Opcional. Por que você escolheu a nota, em até 200
                        caracteres: o que faltou, o que estava errado ou o que
                        foi especialmente útil. Omita dados privados.
                    - type: 'null'
              required:
                - rating
              additionalProperties: false
        required: true
      responses:
        '200':
          description: o Run já tem uma avaliação; a primeira é mantida
          content:
            application/json:
              schema:
                type: object
                properties:
                  review_id:
                    type: string
                  run_id:
                    type: string
                  status:
                    type: string
                    enum:
                      - recorded
                      - already_reviewed
                    description: >-
                      recorded: este envio foi salvo. already_reviewed: este Run
                      já tem uma avaliação; a primeira é mantida e este envio
                      não foi salvo.
                  created_at:
                    type: string
                    description: Quando a avaliação mantida foi enviada.
                    format: date-time
                required:
                  - review_id
                  - run_id
                  - status
                  - created_at
                additionalProperties: false
        '201':
          description: uma avaliação recém-registrada
          content:
            application/json:
              schema:
                type: object
                properties:
                  review_id:
                    type: string
                  run_id:
                    type: string
                  status:
                    type: string
                    enum:
                      - recorded
                      - already_reviewed
                    description: >-
                      recorded: este envio foi salvo. already_reviewed: este Run
                      já tem uma avaliação; a primeira é mantida e este envio
                      não foi salvo.
                  created_at:
                    type: string
                    description: Quando a avaliação mantida foi enviada.
                    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.