---
title: "Submit feedback on an API result"
method: POST
path: "/feedback"
tags: ["Utility"]
---

# Submit feedback on an API result

`POST /feedback`

## Request

- Base URL: `https://riskmodels.app/api`
- URL: `https://riskmodels.app/api/feedback`
- Auth: HTTP bearer

Flag a specific result by its _agent.request_id with a rating / category / correction note. Trust-loop signal for offline data-quality and docs triage; no output changes at request time. Authenticated, free (no metering). Provide at least one of rating, category, or comment.

## Request body

- object
  - `request_id` string: The _agent.request_id / X-Request-ID of the call being rated. Nullable for general feedback.
  - `capability_id` string
  - `rating` 'up' | 'down'
  - `category` 'data_quality' | 'incorrect_result' | 'latency' | 'docs' | 'feature_request' | 'other'
  - `comment` string

## Response `201`

Feedback recorded.

- object
  - `ok` boolean
  - `feedback_id` string
  - `message` string

## Other responses

- `400`: Invalid or empty feedback (no rating/category/comment, bad enum, or comment too long).
- `401`: Missing or invalid API key.
- `503`: Feedback store temporarily unavailable (retry).

---

[API](https://skmtc.dev/riskmodels/apis/riskmodels-api.md) · [All operations](https://skmtc.dev/riskmodels/apis/riskmodels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/riskmodels/apis/riskmodels-api/revisions/1a034cad408a?raw)