Skip to main content

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.

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

EntityDescription
AMBIENT_GENERATED_MEDICAL_FORMFeedback 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.
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:
{
  "feedback": {
    "ratingFeedback": {
      "min_rating": 1,
      "max_rating": 5,
      "rating": 4
    }
  },
  "feedback_metadata": {
    "form_id": "018f94e8-7aa8-7bfd-bc83-046262001234"
  }
}

​
Endpoints

Form Filling Session Feedback

Submit feedback for a form-filling session entity

Last modified on May 22, 2026