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

# Feedback API

<Badge icon="arrow-left" color="gray">[Back to API List](/ai-for-service/apis/searchai/api-list)</Badge>

This API captures user feedback and stores it in Search AI, where it is displayed as part of Answer Analytics.

| Field             | Value                                                     |
| ----------------- | --------------------------------------------------------- |
| **Method**        | POST                                                      |
| **Endpoint**      | `https://{{host}}/api/public/bot/<AppId>/search/feedback` |
| **Content-Type**  | `application/json`                                        |
| **Authorization** | `auth: <JWT Token>`                                       |
| **API Scope**     | Feedback for Search AI                                    |

## Query Parameters

| Parameter | Description                                                                                           | Mandatory |
| --------- | ----------------------------------------------------------------------------------------------------- | --------- |
| `AppID`   | Your application ID. To view it, go to **Dev Tools** under **App Settings** and check the API scopes. | Yes       |

## Request Parameters

| Parameter         | Description                                                                                                                                              | Mandatory |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| `searchRequestId` | The search request ID returned with the answer in response to a search query. Starts with `fsh`, for example `fsh-a7dd595f-xxxx-xxxx-9b1c-7635d6ea113c`. | Yes       |
| `feedbackLevel`   | Currently supports only `smartAnswer`.                                                                                                                   | Yes       |
| `event`           | The feedback response: `thumbsDown` (negative) or `thumbsUp` (positive).                                                                                 | Yes       |
| `comments`        | Optional user comments. Use the `tags` field to pass an array of strings. These values are displayed in the Answer Insights details page.                | No        |

## Sample Request

```bash theme={null}
curl --location 'https://env.domain.com/api/public/bot/st-66c4xxxx-6eae-5ada-b0f8-a2022e945a10/search/feedback' \
--header 'auth: eyJhbGciOiJaxxxxxxx_abcd' \
--header 'Content-Type: application/json' \
--data '{
    "searchRequestId": "fsh-a7dd595f-7ba2-59c2-9b1c-7635d6ea113c",
    "feedbackLevel": "smartAnswer",
    "event": "thumbsDown",
    "comments": {
        "tags": [
            "Incorrect Answer",
            "Incorrect Citation",
            "Incorrect Formatting",
            "Ambiguous",
            "Missing details",
            "Hallucination",
            "Out of Date"
        ]
    }
}'
```