---
title: "Submit agent feedback"
method: POST
path: "/v1/feedback"
tags: ["Feedback"]
---

# Submit agent feedback

`POST /v1/feedback`

## Request

- Base URL: `https://api.inth.com`
- URL: `https://api.inth.com/v1/feedback`
- Auth: HTTP bearer

Report unexpected Inth failures, misleading documentation, missing capabilities, or workarounds. Include expected and actual behavior and an optional request ID. Submit once per distinct issue and continue the original task if reporting fails. Do not report routine validation errors or include credentials, personal data, customer payloads, or full transcripts. Reports go to the Inth team; follow the user's permission to send feedback. Accepts an API key or OAuth bearer without a product scope or organization role. No credits charged. Ten new reports per caller per UTC clock hour. Resubmitting identical content within a UTC day returns the existing reference with 200 and does not consume that quota.

## Request body

- AgentFeedbackSubmission
  - `category` 'bug' | 'friction' | 'docs_mismatch' | 'feature_request' | 'performance', required
  - `surface` 'api' | 'mcp' | 'cli' | 'docs' | 'sdk' | 'dashboard' | 'other': Affected Inth surface. Use `other` when none fit.
  - `message` string, required: Leading and trailing whitespace is trimmed before validation and storage. Must contain non-whitespace text; length limits apply after trimming.
  - `expected` string: Leading and trailing whitespace is trimmed before validation and storage. Must contain non-whitespace text; length limits apply after trimming.
  - `actual` string: Leading and trailing whitespace is trimmed before validation and storage. Must contain non-whitespace text; length limits apply after trimming.
  - `reproduction` string: Leading and trailing whitespace is trimmed before validation and storage. Must contain non-whitespace text; length limits apply after trimming.
  - `requestId` string: Leading and trailing whitespace is trimmed before validation and storage. Must contain non-whitespace text; length limits apply after trimming.
  - `operation` string: Leading and trailing whitespace is trimmed before validation and storage. Must contain non-whitespace text; length limits apply after trimming.
  - `clientName` string: Leading and trailing whitespace is trimmed before validation and storage. Must contain non-whitespace text; length limits apply after trimming.
  - `clientVersion` string: Leading and trailing whitespace is trimmed before validation and storage. Must contain non-whitespace text; length limits apply after trimming.

## Response `200`

Identical report already accepted today. alreadySubmitted is true.

- object
  - `success` true, required
  - `data` AgentFeedbackResult, required
    - `reference` string, required: Feedback or feature-request ticket reference.
    - `alreadySubmitted` boolean, required

## Other responses

- `201`: Report saved to the Inth feedback inbox.
- `400`: The request payload or parameters are invalid.
- `401`: Authentication is missing, invalid, or expired.
- `403`: The credential is valid but may not perform the operation. `INSUFFICIENT_SCOPE`: the credential was never granted the capability the operation needs. `details.requiredScope` names it, and the `WWW-Authenticate` header carries `Bearer error="insufficient_scope"`. An OAuth client fixes this by requesting the scope; an organization API key cannot gain it. `FORBIDDEN`: the capability is present but the membership behind the credential lacks the role, or the resource belongs to another organization.
- `413`: Request exceeds 64 KB.
- `429`: The rate limit was exceeded. API key limits are set by plan tier (Starter 600/min, Pro 1500/min, Enterprise 3000/min). Check the Retry-After header before retrying.
- `500`: An unexpected internal error occurred.
- `503`: Feedback submissions are temporarily paused.

## Changes

- **2026-09-28** `91eb68593be2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/inth/apis/inth-api/changes/v1/feedback/post.md)

---

[API](https://skmtc.dev/inth/apis/inth-api.md) - [All operations](https://skmtc.dev/inth/apis/inth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/inth/apis/inth-api/revisions/5a1be8d43402?raw)