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

# Feedback API

[Back to API List](https://koreai.mintlify.site/ai-for-service/apis/searchai/api-list)

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 expandable=true 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"
        ]
    }
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.