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

> Submit user feedback on AI generations. Record quality ratings, thumbs up/down signals, corrections, and custom scores via the feedback endpoint.



## OpenAPI

````yaml post /v2/feedback
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:
    post:
      tags:
        - Feedback
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                  format: ulid
                  description: Unique identifier for the feedback
                property:
                  type: string
                  description: A string describing the specific property or aspect rated.
                value:
                  anyOf:
                    - type: string
                    - type: number
                    - type: array
                      items:
                        type: string
                  description: >-
                    The feedback value. For single selection of multiple choice,
                    the value should be an array of strings. For `correction`,
                    the value should be a string.
                trace_id:
                  type: string
                  description: >-
                    The id returned by the
                    [`get_config`](https://docs.orq.ai/reference/deployments/get-config)
                    or
                    [`invoke`](https://docs.orq.ai/reference/deployments/invoke)
                    endpoints
                product:
                  type: string
                  enum:
                    - remoteconfigs
                    - deployments
                    - experiments
                    - playgrounds
                    - spreadsheets
                    - spreadsheet_run
                    - llm_evaluator
                    - knowledge
                    - router
                    - workflows
                    - external_events
                    - agents
                    - memory-stores
                    - generic
                    - evaluators
                    - otel
                    - ai-chat
                  default: deployments
              required:
                - property
                - value
                - trace_id
      responses:
        '200':
          description: Event has been dispatched to delete the feedback
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: ulid
                    description: Unique identifier for the feedback
                  property:
                    type: string
                    description: A string describing the specific property or aspect rated.
                  value:
                    anyOf:
                      - type: string
                      - type: number
                      - type: array
                        items:
                          type: string
                    description: >-
                      The feedback value. For single selection of multiple
                      choice, the value should be an array of strings. For
                      `correction`, the value should be a string.
                  trace_id:
                    type: string
                    description: >-
                      The id returned by the
                      [`get_config`](https://docs.orq.ai/reference/deployments/get-config)
                      or
                      [`invoke`](https://docs.orq.ai/reference/deployments/invoke)
                      endpoints
                  product:
                    type: string
                    enum:
                      - remoteconfigs
                      - deployments
                      - experiments
                      - playgrounds
                      - spreadsheets
                      - spreadsheet_run
                      - llm_evaluator
                      - knowledge
                      - router
                      - workflows
                      - external_events
                      - agents
                      - memory-stores
                      - generic
                      - evaluators
                      - otel
                      - ai-chat
                    default: deployments
                required:
                  - property
                  - value
                  - trace_id
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '404':
          description: Workspace ID is not found on the request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
components:
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````