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

# Form Filling Feedback

> Submit feedback for a Form filling session

The Form filling feedback APIs let you submit feedback for a **Form filling ambient session**. These APIs use **SubmitFormFillingFeedback**, which is separate from the ambient **SubmitFeedback** flow.

## Usage scenarios

* Submit feedback for a generated medical form in a Form filling session

## Session requirements

* `ambient_session_id` must reference a **Form filling** session with the underlying job type `FORM_FILLING_ORCHESTRATION`.
* If the session is not a Form filling session, the API returns a `FailedPrecondition` error.

## Entity types

| Entity                           | Description                                          |
| :------------------------------- | :--------------------------------------------------- |
| `AMBIENT_GENERATED_MEDICAL_FORM` | Feedback for a generated medical form in the session |

When `entity` is `AMBIENT_GENERATED_MEDICAL_FORM`, you must provide `feedback_metadata.form_id` with the generated medical form instance ID. The API uses this ID to load the form details before forwarding the request to the feedback service.

## Rating system

Inside **`feedback`**, the `ratingFeedback` object provides quantitative feedback. It includes the following fields:

* `min_rating`: The minimum rating value (e.g., 0).
* `max_rating`: The maximum rating value.
* `rating`: The actual rating you provide within the min-max range.

<Note>
  Configure the rating scale by setting the `min_rating` and `max_rating` values. The range is **inclusive**, so both the `min_rating` and `max_rating` values are valid ratings.

  For example:

  ```json theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
  {
    "feedback": {
      "ratingFeedback": {
        "min_rating": 1,
        "max_rating": 5,
        "rating": 4
      }
    },
    "feedback_metadata": {
      "form_id": "018f94e8-7aa8-7bfd-bc83-046262001234"
    }
  }
  ```
</Note>

## Endpoints