---
title: "Validate a structured agent correction proposal; persist only with FEEDBACK_SECRET authorization."
method: POST
path: "/api/feedback/proposals"
---

# Validate a structured agent correction proposal; persist only with FEEDBACK_SECRET authorization.

`POST /api/feedback/proposals`

## Request

- Base URL: `https://git.top`
- URL: `https://git.top/api/feedback/proposals`
- Auth: one of:
  - none
  - HTTP bearer

## Request body

- FeedbackProposalRequest
  - `project_id` string, required
  - `feedback_type` 'classification' | 'alternative' | 'metadata' | 'stale' | 'other', required
  - `proposed` object, required
  - `evidence` object[], required
  - `rationale` string, required
  - `source_agent` string
  - `source_url` string, uri

## Response `200`

Validated proposal that was not persisted

- FeedbackProposalResponse
  - `proposal` object, required
  - `persisted` boolean, required
  - `review_required` true, required
  - `mutation_policy` string, required
  - `authorization` string, required

## Other responses

- `202`: Authenticated proposal persisted for review
- `400`: Invalid proposal
- `401`: Invalid feedback authorization

---

[API](https://skmtc.dev/git/apis/git-top-agent-api.md) · [All operations](https://skmtc.dev/git/apis/git-top-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/git/apis/git-top-agent-api/revisions/c9ebf661ef6d?raw)