AI Feedback API

Endpoints for submitting and querying user feedback on AI-generated suggestions. Feedback data powers acceptance-rate dashboards in the admin panel.

Endpoints Overview

Method	Endpoint	Description	Auth
POST	/ai-feedback	Submit feedback	Any authenticated user
GET	/ai-feedback/stats	Aggregated statistics	Superadmin
GET	/ai-feedback/export	Export as CSV or JSON	Superadmin
GET	/ai-feedback	Paginated feedback list	Superadmin

---

Submit Feedback

POST /ai-feedback

Request Body

{
  "ai_log_id": "550e8400-e29b-41d4-a716-446655440000",
  "feature": "description_generation",
  "action": "edited",
  "comment": "Added business context about quarterly reporting",
  "original_value": "Contains customer financial data.",
  "edited_value": "Contains customer financial data aggregated for quarterly board reporting."
}

Action Values

Action	Meaning
thumbs_up	Suggestion is accurate as-is
thumbs_down	Suggestion is not useful
accepted	Suggestion applied directly
edited	Suggestion modified before applying
rejected	Suggestion dismissed

Response — 201 Created

{
  "id": "a1b2c3d4-...",
  "ai_log_id": "550e8400-...",
  "user_id": "u-123-...",
  "feature": "description_generation",
  "action": "edited",
  "comment": "Added business context about quarterly reporting",
  "original_value": "Contains customer financial data.",
  "edited_value": "Contains customer financial data aggregated for quarterly board reporting.",
  "created_at": "2026-03-02T12:00:00Z"
}

---

Get Feedback Stats

GET /ai-feedback/stats?feature=description_generation&days=30

Returns aggregated acceptance rates grouped by AI feature.

Query Parameters

Parameter	Type	Default	Description
feature	string	—	Filter by feature name
days	int	30	Time window in days

Response

[
  {
    "feature": "description_generation",
    "total_count": 142,
    "thumbs_up_count": 45,
    "thumbs_down_count": 12,
    "accepted_count": 58,
    "edited_count": 20,
    "rejected_count": 7,
    "acceptance_rate": 86.6
  }
]

---

Export Feedback

GET /ai-feedback/export?format=csv&feature=description_generation

Returns all feedback entries as CSV or JSON. Limited to 10,000 entries.

Query Parameters

Parameter	Type	Default	Description
format	string	csv	Export format: csv or json
feature	string	—	Filter by feature name

---

List Feedback

GET /ai-feedback?skip=0&limit=50&feature=description_generation

Response

{
  "items": [
    {
      "id": "a1b2c3d4-...",
      "feature": "description_generation",
      "action": "thumbs_up",
      "comment": null,
      "ai_log_id": "550e8400-...",
      "user_id": "u-123-...",
      "original_value": null,
      "edited_value": null,
      "created_at": "2026-03-02T12:00:00Z"
    }
  ],
  "total": 142
}