---
title: "Submit ambient session feedback"
method: POST
path: "/api/v1/ambient/session/{session_id}/{entity}/feedback"
tags: ["/api/v1/ambient/session/{session_id}/{entity}/feedback"]
---

# Submit ambient session feedback

`POST /api/v1/ambient/session/{session_id}/{entity}/feedback`

Submits quantitative and qualitative feedback on AI-generated clinical content for an ambient session. You can submit feedback once per entity type per session.

## Path parameters

- `session_id` string, required
- `entity` string, required

## Headers

- `sdp_provider_id` string

## Request body

- ControllersFeedbackRequest — Quantitative rating and optional qualitative comments for the specified entity.
  - `ratingFeedback` object, required — Required quantitative rating. Set `min_rating`, `max_rating`, and `rating` to define the scale and score.
    - `min_rating` integer, required — Minimum rating value - you can choose any number as the minimum i.e 0 and above
    - `max_rating` integer, required — Maximum rating value - you can choose any number that is greater than the minimum value
    - `rating` integer, required — The actual rating given within the min-max range
  - `qualitative_comments` string — **Optional** - Qualitative feedback comments for detailed insights. Maximum 2000 characters allowed.

## Response `201`

Resource created successfully.

- ControllersFeedbackResponse — Response body for successful feedback submission
  - `feedback_id` string — Unique identifier for the submitted feedback

## Other responses

- `400` — Bad request. The request body or parameters failed validation.
- `401` — Unauthorized - Authentication failed or invalid token
- `403` — Forbidden - Access denied to the requested resource
- `404` — Not found. The session, encounter, or resource ID does not exist.
- `500` — Internal server error.

---

[API](https://skmtc.dev/suki/apis/suki-developer-platform.md) · [All operations](https://skmtc.dev/suki/apis/suki-developer-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/suki/suki-developer-platform/revisions/5f420a18fb68/schema)