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

# Submit evaluation feedback

> Submit automated evaluation feedback for a generation. Attach evaluator scores and reasoning to specific AI response traces programmatically.



## OpenAPI

````yaml post /v2/feedback/evaluation
openapi: 3.1.0
info:
  title: orq.ai API
  version: '2.0'
  description: orq.ai API documentation
servers:
  - url: https://api.orq.ai
security:
  - ApiKey: []
tags:
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: Files
    description: File upload and retrieval operations.
  - name: FilesService
  - name: Projects
    description: Projects organize resources within a workspace
  - name: ProjectsService
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: SkillsService
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Reporting
    description: >-
      GenAI reporting API over canonical analytics rollups. Accepts a metric
      name, time range, grain, group-by, and filters; returns a typed time
      series and optional totals.
  - name: ReportingService
    description: |-
      ReportingService exposes a single QueryReport RPC that maps allowlisted
       analytics payloads onto safe rollup queries. Callers never send SQL;
       the backend picks the rollup family and grain from the metric
       catalogue, the requested range, and the requested grouping.
externalDocs:
  url: https://docs.orq.ai
  description: orq.ai Documentation
paths:
  /v2/feedback/evaluation:
    post:
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
                - type: object
                  properties:
                    id:
                      type: string
                      description: The unique identifier of the human evaluation
                    evaluation_type:
                      type: string
                      enum:
                        - human_review
                      description: The type of evaluation
                    human_review_id:
                      type: string
                      description: The unique identifier of the human review
                    source:
                      type: string
                      enum:
                        - orq
                        - external
                      default: orq
                    reviewed_at:
                      type: string
                      format: date-time
                      default: '2026-05-14T21:19:53.503Z'
                      description: The date and time the item was reviewed
                    type:
                      type: string
                      enum:
                        - string
                    value:
                      type: string
                    trace_id:
                      type: string
                  required:
                    - id
                    - evaluation_type
                    - human_review_id
                    - type
                    - value
                    - trace_id
                - type: object
                  properties:
                    id:
                      type: string
                      description: The unique identifier of the human evaluation
                    evaluation_type:
                      type: string
                      enum:
                        - human_review
                      description: The type of evaluation
                    human_review_id:
                      type: string
                      description: The unique identifier of the human review
                    source:
                      type: string
                      enum:
                        - orq
                        - external
                      default: orq
                    reviewed_at:
                      type: string
                      format: date-time
                      default: '2026-05-14T21:19:53.504Z'
                      description: The date and time the item was reviewed
                    type:
                      type: string
                      enum:
                        - number
                    value:
                      type: number
                    trace_id:
                      type: string
                  required:
                    - id
                    - evaluation_type
                    - human_review_id
                    - type
                    - value
                    - trace_id
                - type: object
                  properties:
                    id:
                      type: string
                      description: The unique identifier of the human evaluation
                    evaluation_type:
                      type: string
                      enum:
                        - human_review
                      description: The type of evaluation
                    human_review_id:
                      type: string
                      description: The unique identifier of the human review
                    source:
                      type: string
                      enum:
                        - orq
                        - external
                      default: orq
                    reviewed_at:
                      type: string
                      format: date-time
                      default: '2026-05-14T21:19:53.504Z'
                      description: The date and time the item was reviewed
                    type:
                      type: string
                      enum:
                        - string_array
                    values:
                      type: array
                      items:
                        type: string
                    trace_id:
                      type: string
                  required:
                    - id
                    - evaluation_type
                    - human_review_id
                    - type
                    - values
                    - trace_id
      responses:
        '200':
          description: Event has been dispatched to report the feedback
components:
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````