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

# Create a review for an execution (SDK)



## OpenAPI

````yaml /api-reference/openapi.json post /api/v1/runtime/v1/observability/executions/{executionId}/reviews
openapi: 3.0.0
info:
  title: Runflow Runtime API
  description: >-
    Programmatic surface for the Runflow platform — used by the SDK, the CLI,
    the execution engine, and any server-to-server caller. Authenticate with an
    `x-api-key` header (or `Authorization: Bearer ...`).
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.runflow.ai
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
tags: []
paths:
  /api/v1/runtime/v1/observability/executions/{executionId}/reviews:
    post:
      tags:
        - Runtime API - Observability
      summary: Create a review for an execution (SDK)
      operationId: RuntimeObservabilityController_createExecutionReview
      parameters:
        - name: executionId
          required: true
          in: path
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateExecutionReviewDto'
      responses:
        '201':
          description: Review created
      security:
        - bearer: []
components:
  schemas:
    CreateExecutionReviewDto:
      type: object
      properties:
        agentId:
          type: string
          description: Agent ID
          example: 66602e46-748e-44f2-a5aa-3712c2393436
        rating:
          type: string
          description: Rating of the execution
          enum:
            - good
            - bad
            - needs_improvement
          example: bad
        comment:
          type: string
          description: Comment explaining the review
          minLength: 10
          example: Bot forneceu informação incorreta sobre horário de funcionamento
        tags:
          description: Tags to categorize the issue
          example:
            - wrong_info
            - business_hours
          type: array
          items:
            type: string
        priority:
          type: string
          description: Priority level
          enum:
            - low
            - medium
            - high
            - critical
          default: medium
      required:
        - agentId
        - rating
        - comment

````