---
title: "Build a feedback prompt for a scorecard item"
method: POST
path: "/api/v1/feedback/prompt"
tags: ["feedback"]
---

# Build a feedback prompt for a scorecard item

`POST /api/v1/feedback/prompt`

## Request body

- FeedbackBuildPromptRequestDTO
  - `item` object, required — The feedback item to generate a prompt for
    - `description` string, required
    - `desired_behaviours` object[], nullable
      - `behaviour` string, required
      - `examples` string, nullable
      - `id` string, required
    - `desired_outcome` string, nullable
    - `id` string, required
    - `item_title` string, required
  - `playedLanguage` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'pl' | 'zh' | 'ja' | 'id' | 'tr' | 'pt' | 'el' | 'ko' | 'vi' | 'hi' | 'ms' | 'th' | 'hr' | 'ro' | 'bg' | 'sv' | 'no' | 'yue' — The language the conversation was played in. Defaults to the scorecard language when omitted.
  - `scorecard` object, required — The scorecard containing the evaluation criteria
    - `createdAt` string, required
    - `id` string, required
    - `items` object[], required
      - `description` string, required
      - `desired_behaviours` object[], nullable
        - `behaviour` string, required
        - `examples` string, nullable
        - `id` string, required
      - `desired_outcome` string, nullable
      - `id` string, required
      - `item_title` string, required
    - `language` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'zh-Hans', required
    - `saga` object, required
      - `createdAt` string, required — Creation timestamp
      - `description` string, required — Description of the saga
      - `id` string, required — Unique identifier for the saga
      - `name` string, required — Name of the saga
      - `type` 'under_construction' | 'generic' | 'client_specific' — Type of the saga
      - `updatedAt` string, required — Last update timestamp
    - `tag` string, required
    - `title` string, required
    - `updatedAt` string, required

## Response `201`

- FeedbackBuildPromptResponseDTO
  - `prompt` string, required — The generated feedback prompt

---

[API](https://skmtc.net/wejam/apis/jam.md) · [All operations](https://skmtc.net/wejam/apis/jam/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wejam/jam/revisions/bd5a5f406bca/schema)