---
title: "Provide Feedback"
method: POST
path: "/agents/{agent_id}/feedback"
tags: ["/agents/{id}/query"]
---

# Provide Feedback

`POST /agents/{agent_id}/feedback`

Provide feedback for a generation or a retrieval. Feedback can be used to track overall `Agent` performance through the `Feedback` page in the Contextual UI, and as a basis for model fine-tuning.

## Path parameters

- `agent_id` string, uuid, required — ID of the agent for which to provide feedback

## Request body

- FeedbackRequestV01 — Input to POST feedback endpoint
  - `message_id` string, uuid, required — ID of the message on which to provide feedback.
  - `feedback` 'thumbs_up' | 'thumbs_down' | 'flagged' | 'removed', required
  - `explanation` string — Optional explanation for the feedback.
  - `content_id` string, uuid — ID of the content on which to provide feedback, if feedback is on retrieval. Do not set (or set to null) while providing generation feedback.

## Response `200`

Successful Response

- FeedbackSubmitResponse — Response schema for feedback submission endpoint.
  - `feedback_id` string, uuid, required — ID of the submitted or updated feedback.

## Other responses

- `422` — Validation Error

## Changes

- **2025-10-28** `c8152db45500` — 1 info
  - added the required property `feedback_id` to the response with the `200` status
- **2025-01-14** `4dd01a1cc34b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/agents/:agent_id/feedback/post.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contextualai/endpoints/revisions/ca7f807eec8b/schema)