SeggWat LogoSeggWat
BlogDashboard
POST/agent/{project_key}/feedback

Submit an agent report

Files a structured report. It lands in the project's feedback inbox with source `AgentReport`; the category maps to a feedback type (bug/quality_degradation → Bug, feature_gap → Feature, friction/docs_mismatch → Improvement, other → Other). Rate limited with the other public submit endpoints (bursts of 20, about 60/hour per IP). No authentication. Wire-compatible with the agent feedback protocol (discovery at `/.well-known/agent-feedback.json`).

Base URLhttps://seggwat.com/api/v1

Parameters

project_keypathstring (uuid)required

The project key (UUID) shown in Project Settings. Agent reports must be enabled for the project.

Request Body

required
application/json
AgentFeedbackInput
contentobjectrequired
evidencearray<object>
reporterobject

Optional. Fields left out are derived from the User-Agent header's first name/version token; agent_vendor defaults to "unknown".

signalobjectrequired
subjectobjectrequired
Example
{
  "content": {
    "hypothesis": "v2 dropped X-API-Key and the auth page still documents v1.",
    "summary": "The auth page says to send X-API-Key. GET /v2/orders returns 401 with it and 200 with Authorization: Bearer.",
    "title": "Docs say X-API-Key, but /v2/orders only accepts Authorization: Bearer"
  },
  "evidence": [
    {
      "content": "GET /v2/orders\nX-API-Key: [REDACTED]\n-> 401",
      "redacted": true,
      "type": "http_summary"
    }
  ],
  "reporter": {
    "agent_product": "claude-code",
    "agent_vendor": "anthropic",
    "agent_version": "2.1.0"
  },
  "signal": {
    "category": "docs_mismatch",
    "confidence": 0.9,
    "reproducibility": "always",
    "severity": "medium"
  },
  "subject": {
    "domain": "api.acme.com",
    "kind": "api_endpoint",
    "surface": "GET /v2/orders"
  }
}

Responses

Navigation